@squadbase/vite-server 0.1.9-dev.f236b23 → 0.1.10-dev.5aa0720

package/dist/cli/index.js

@@ -910,17 +910,17 @@ var require_nacl_fast = __commonJS({
       }
       var sigma = new Uint8Array([101, 120, 112, 97, 110, 100, 32, 51, 50, 45, 98, 121, 116, 101, 32, 107]);
       function crypto_stream_salsa20_xor(c6, cpos, m4, mpos, b6, n2, k6) {
-        var z96 = new Uint8Array(16), x = new Uint8Array(64);
+        var z98 = new Uint8Array(16), x = new Uint8Array(64);
         var u, i6;
-        for (i6 = 0; i6 < 16; i6++) z96[i6] = 0;
-        for (i6 = 0; i6 < 8; i6++) z96[i6] = n2[i6];
+        for (i6 = 0; i6 < 16; i6++) z98[i6] = 0;
+        for (i6 = 0; i6 < 8; i6++) z98[i6] = n2[i6];
         while (b6 >= 64) {
-          crypto_core_salsa20(x, z96, k6, sigma);
+          crypto_core_salsa20(x, z98, k6, sigma);
           for (i6 = 0; i6 < 64; i6++) c6[cpos + i6] = m4[mpos + i6] ^ x[i6];
           u = 1;
           for (i6 = 8; i6 < 16; i6++) {
-            u = u + (z96[i6] & 255) | 0;
-            z96[i6] = u & 255;
+            u = u + (z98[i6] & 255) | 0;
+            z98[i6] = u & 255;
             u >>>= 8;
           }
           b6 -= 64;
@@ -928,30 +928,30 @@ var require_nacl_fast = __commonJS({
           mpos += 64;
         }
         if (b6 > 0) {
-          crypto_core_salsa20(x, z96, k6, sigma);
+          crypto_core_salsa20(x, z98, k6, sigma);
           for (i6 = 0; i6 < b6; i6++) c6[cpos + i6] = m4[mpos + i6] ^ x[i6];
         }
         return 0;
       }
       function crypto_stream_salsa20(c6, cpos, b6, n2, k6) {
-        var z96 = new Uint8Array(16), x = new Uint8Array(64);
+        var z98 = new Uint8Array(16), x = new Uint8Array(64);
         var u, i6;
-        for (i6 = 0; i6 < 16; i6++) z96[i6] = 0;
-        for (i6 = 0; i6 < 8; i6++) z96[i6] = n2[i6];
+        for (i6 = 0; i6 < 16; i6++) z98[i6] = 0;
+        for (i6 = 0; i6 < 8; i6++) z98[i6] = n2[i6];
         while (b6 >= 64) {
-          crypto_core_salsa20(x, z96, k6, sigma);
+          crypto_core_salsa20(x, z98, k6, sigma);
           for (i6 = 0; i6 < 64; i6++) c6[cpos + i6] = x[i6];
           u = 1;
           for (i6 = 8; i6 < 16; i6++) {
-            u = u + (z96[i6] & 255) | 0;
-            z96[i6] = u & 255;
+            u = u + (z98[i6] & 255) | 0;
+            z98[i6] = u & 255;
             u >>>= 8;
           }
           b6 -= 64;
           cpos += 64;
         }
         if (b6 > 0) {
-          crypto_core_salsa20(x, z96, k6, sigma);
+          crypto_core_salsa20(x, z98, k6, sigma);
           for (i6 = 0; i6 < b6; i6++) c6[cpos + i6] = x[i6];
         }
         return 0;
@@ -1831,12 +1831,12 @@ var require_nacl_fast = __commonJS({
         for (a6 = 0; a6 < 16; a6++) o2[a6] = c6[a6];
       }
       function crypto_scalarmult(q2, n2, p2) {
-        var z96 = new Uint8Array(32);
+        var z98 = new Uint8Array(32);
         var x = new Float64Array(80), r6, i6;
         var a6 = gf(), b6 = gf(), c6 = gf(), d6 = gf(), e6 = gf(), f6 = gf();
-        for (i6 = 0; i6 < 31; i6++) z96[i6] = n2[i6];
-        z96[31] = n2[31] & 127 | 64;
-        z96[0] &= 248;
+        for (i6 = 0; i6 < 31; i6++) z98[i6] = n2[i6];
+        z98[31] = n2[31] & 127 | 64;
+        z98[0] &= 248;
         unpack25519(x, p2);
         for (i6 = 0; i6 < 16; i6++) {
           b6[i6] = x[i6];
@@ -1844,7 +1844,7 @@ var require_nacl_fast = __commonJS({
         }
         a6[0] = d6[0] = 1;
         for (i6 = 254; i6 >= 0; --i6) {
-          r6 = z96[i6 >>> 3] >>> (i6 & 7) & 1;
+          r6 = z98[i6 >>> 3] >>> (i6 & 7) & 1;
           sel25519(a6, b6, r6);
           sel25519(c6, d6, r6);
           A(e6, a6, c6);
@@ -4861,8 +4861,8 @@ var require_poly1305 = __commonJS({
         });
         var u = {}, w;
         for (w in b6) b6.hasOwnProperty(w) && (u[w] = b6[w]);
-        var x = "object" === typeof window, y = "function" === typeof importScripts, z96 = "object" === typeof process && "object" === typeof process.versions && "string" === typeof process.versions.node, B = "", C, D, E, F, G;
-        if (z96) B = y ? __require("path").dirname(B) + "/" : __dirname + "/", C = function(a6, c6) {
+        var x = "object" === typeof window, y = "function" === typeof importScripts, z98 = "object" === typeof process && "object" === typeof process.versions && "string" === typeof process.versions.node, B = "", C, D, E, F, G;
+        if (z98) B = y ? __require("path").dirname(B) + "/" : __dirname + "/", C = function(a6, c6) {
           var d6 = H(a6);
           if (d6) return c6 ? d6 : d6.toString();
           F || (F = __require("fs"));
@@ -5118,7 +5118,7 @@ var require_poly1305 = __commonJS({
         function H(a6) {
           if (a6.startsWith(V)) {
             a6 = a6.slice(V.length);
-            if ("boolean" === typeof z96 && z96) {
+            if ("boolean" === typeof z98 && z98) {
               var c6 = Buffer.from(a6, "base64");
               c6 = new Uint8Array(c6.buffer, c6.byteOffset, c6.byteLength);
             } else try {
@@ -39041,14 +39041,14 @@ var init_NormalizedSchema = __esm({
           throw new Error("@smithy/core/schema - cannot iterate non-struct schema.");
         }
         const struct = this.getSchema();
-        const z96 = struct[4].length;
+        const z98 = struct[4].length;
         let it = struct[anno.it];
-        if (it && z96 === it.length) {
+        if (it && z98 === it.length) {
           yield* it;
           return;
         }
-        it = Array(z96);
-        for (let i6 = 0; i6 < z96; ++i6) {
+        it = Array(z98);
+        for (let i6 = 0; i6 < z98; ++i6) {
           const k6 = struct[4][i6];
           const v = member([struct[5][i6], 0], k6);
           yield it[i6] = [k6, v];
@@ -39729,12 +39729,12 @@ var init_split_header = __esm({
   "../../node_modules/@smithy/core/dist-es/submodules/serde/split-header.js"() {
     "use strict";
     splitHeader = (value) => {
-      const z96 = value.length;
+      const z98 = value.length;
       const values = [];
       let withinQuotes = false;
       let prevChar = void 0;
       let anchor = 0;
-      for (let i6 = 0; i6 < z96; ++i6) {
+      for (let i6 = 0; i6 < z98; ++i6) {
         const char = value[i6];
         switch (char) {
           case `"`:
@@ -39755,12 +39755,12 @@ var init_split_header = __esm({
       values.push(value.slice(anchor));
       return values.map((v) => {
         v = v.trim();
-        const z97 = v.length;
-        if (z97 < 2) {
+        const z99 = v.length;
+        if (z99 < 2) {
           return v;
         }
-        if (v[0] === `"` && v[z97 - 1] === `"`) {
-          v = v.slice(1, z97 - 1);
+        if (v[0] === `"` && v[z99 - 1] === `"`) {
+          v = v.slice(1, z99 - 1);
         }
         return v.replace(/\\"/g, '"');
       });
@@ -41197,11 +41197,11 @@ var init_EndpointCache = __esm({
       }
       hash(endpointParams) {
         let buffer = "";
-        const { parameters: parameters79 } = this;
-        if (parameters79.length === 0) {
+        const { parameters: parameters80 } = this;
+        if (parameters80.length === 0) {
           return false;
         }
-        for (const param of parameters79) {
+        for (const param of parameters80) {
           const val = String(endpointParams[param] ?? "");
           if (val.includes("|;")) {
             return false;
@@ -47673,8 +47673,8 @@ var init_ProtocolLib = __esm({
       constructor(queryCompat = false) {
         this.queryCompat = queryCompat;
       }
-      resolveRestContentType(defaultContentType, inputSchema95) {
-        const members = inputSchema95.getMemberSchemas();
+      resolveRestContentType(defaultContentType, inputSchema97) {
+        const members = inputSchema97.getMemberSchemas();
         const httpPayloadMember = Object.values(members).find((m4) => {
           return !!m4.getMergedTraits().httpPayload;
         });
@@ -47689,7 +47689,7 @@ var init_ProtocolLib = __esm({
           } else {
             return defaultContentType;
           }
-        } else if (!inputSchema95.isUnitSchema()) {
+        } else if (!inputSchema97.isUnitSchema()) {
           const hasBody = Object.values(members).find((m4) => {
             const { httpQuery, httpQueryParams, httpHeader, httpLabel, httpPrefixHeaders } = m4.getMergedTraits();
             const noPrefixHeaders = httpPrefixHeaders === void 0;
@@ -48542,9 +48542,9 @@ var init_AwsRestJsonProtocol = __esm({
       }
       async serializeRequest(operationSchema, input, context) {
         const request2 = await super.serializeRequest(operationSchema, input, context);
-        const inputSchema95 = NormalizedSchema.of(operationSchema.input);
+        const inputSchema97 = NormalizedSchema.of(operationSchema.input);
         if (!request2.headers["content-type"]) {
-          const contentType = this.mixin.resolveRestContentType(this.getDefaultContentType(), inputSchema95);
+          const contentType = this.mixin.resolveRestContentType(this.getDefaultContentType(), inputSchema97);
           if (contentType) {
             request2.headers["content-type"] = contentType;
           }
@@ -48556,8 +48556,8 @@ var init_AwsRestJsonProtocol = __esm({
       }
       async deserializeResponse(operationSchema, context, response) {
         const output = await super.deserializeResponse(operationSchema, context, response);
-        const outputSchema95 = NormalizedSchema.of(operationSchema.output);
-        for (const [name, member2] of outputSchema95.structIterator()) {
+        const outputSchema97 = NormalizedSchema.of(operationSchema.output);
+        for (const [name, member2] of outputSchema97.structIterator()) {
           if (member2.getMemberTraits().httpPayload && !(name in output)) {
             output[name] = null;
           }
@@ -54375,22 +54375,22 @@ var init_loadCognitoIdentity = __esm({
 });
 
 // ../../node_modules/@aws-sdk/credential-provider-cognito-identity/dist-es/fromCognitoIdentity.js
-function fromCognitoIdentity(parameters79) {
+function fromCognitoIdentity(parameters80) {
   return async (awsIdentityProperties) => {
-    parameters79.logger?.debug("@aws-sdk/credential-provider-cognito-identity - fromCognitoIdentity");
+    parameters80.logger?.debug("@aws-sdk/credential-provider-cognito-identity - fromCognitoIdentity");
     const { GetCredentialsForIdentityCommand: GetCredentialsForIdentityCommand2, CognitoIdentityClient: CognitoIdentityClient2 } = await Promise.resolve().then(() => (init_loadCognitoIdentity(), loadCognitoIdentity_exports));
-    const fromConfigs = (property) => parameters79.clientConfig?.[property] ?? parameters79.parentClientConfig?.[property] ?? awsIdentityProperties?.callerClientConfig?.[property];
-    const { Credentials: { AccessKeyId = throwOnMissingAccessKeyId(parameters79.logger), Expiration, SecretKey = throwOnMissingSecretKey(parameters79.logger), SessionToken } = throwOnMissingCredentials(parameters79.logger) } = await (parameters79.client ?? new CognitoIdentityClient2(Object.assign({}, parameters79.clientConfig ?? {}, {
+    const fromConfigs = (property) => parameters80.clientConfig?.[property] ?? parameters80.parentClientConfig?.[property] ?? awsIdentityProperties?.callerClientConfig?.[property];
+    const { Credentials: { AccessKeyId = throwOnMissingAccessKeyId(parameters80.logger), Expiration, SecretKey = throwOnMissingSecretKey(parameters80.logger), SessionToken } = throwOnMissingCredentials(parameters80.logger) } = await (parameters80.client ?? new CognitoIdentityClient2(Object.assign({}, parameters80.clientConfig ?? {}, {
       region: fromConfigs("region"),
       profile: fromConfigs("profile"),
       userAgentAppId: fromConfigs("userAgentAppId")
     }))).send(new GetCredentialsForIdentityCommand2({
-      CustomRoleArn: parameters79.customRoleArn,
-      IdentityId: parameters79.identityId,
-      Logins: parameters79.logins ? await resolveLogins(parameters79.logins) : void 0
+      CustomRoleArn: parameters80.customRoleArn,
+      IdentityId: parameters80.identityId,
+      Logins: parameters80.logins ? await resolveLogins(parameters80.logins) : void 0
     }));
     return {
-      identityId: parameters79.identityId,
+      identityId: parameters80.identityId,
       accessKeyId: AccessKeyId,
       secretAccessKey: SecretKey,
       sessionToken: SessionToken,
@@ -67147,11 +67147,11 @@ var require_bignumber = __commonJS({
         return n2 > 0 || n2 === i6 ? i6 : i6 - 1;
       }
       function coeffToString(a6) {
-        var s, z96, i6 = 1, j6 = a6.length, r6 = a6[0] + "";
+        var s, z98, i6 = 1, j6 = a6.length, r6 = a6[0] + "";
         for (; i6 < j6; ) {
           s = a6[i6++] + "";
-          z96 = LOG_BASE - s.length;
-          for (; z96--; s = "0" + s) ;
+          z98 = LOG_BASE - s.length;
+          for (; z98--; s = "0" + s) ;
           r6 += s;
         }
         for (j6 = r6.length; r6.charCodeAt(--j6) === 48; ) ;
@@ -67184,15 +67184,15 @@ var require_bignumber = __commonJS({
       function toExponential(str, e6) {
         return (str.length > 1 ? str.charAt(0) + "." + str.slice(1) : str) + (e6 < 0 ? "e" : "e+") + e6;
       }
-      function toFixedPoint(str, e6, z96) {
+      function toFixedPoint(str, e6, z98) {
         var len, zs;
         if (e6 < 0) {
-          for (zs = z96 + "."; ++e6; zs += z96) ;
+          for (zs = z98 + "."; ++e6; zs += z98) ;
           str = zs + str;
         } else {
           len = str.length;
           if (++e6 > len) {
-            for (zs = z96, e6 -= len; --e6; zs += z96) ;
+            for (zs = z98, e6 -= len; --e6; zs += z98) ;
             str += zs;
           } else if (e6 < len) {
             str = str.slice(0, e6) + "." + str.slice(e6);
@@ -89708,6 +89708,12 @@ var NOOP_TUNNEL = (connectionUrl) => ({
   close: async () => {
   }
 });
+var NOOP_TUNNEL_HOSTPORT = (host, port) => ({
+  host,
+  port,
+  close: async () => {
+  }
+});
 function connectionParamsToRecord(connection) {
   const out = {};
   for (const p2 of connection.parameters) {
@@ -89715,9 +89721,9 @@ function connectionParamsToRecord(connection) {
   }
   return out;
 }
-async function maybeOpenSshTunnel(params, connectionUrl, defaultDbPort) {
+async function maybeOpenSshTunnelHostPort(params, dbHost, dbPort) {
   const sshHost = params[sshTunnelParameters.sshHost.slug];
-  if (!sshHost) return NOOP_TUNNEL(connectionUrl);
+  if (!sshHost) return NOOP_TUNNEL_HOSTPORT(dbHost, dbPort);
   const sshUsername = params[sshTunnelParameters.sshUsername.slug];
   const sshPrivateKeyBase64 = params[sshTunnelParameters.sshPrivateKeyBase64.slug];
   if (!sshUsername || !sshPrivateKeyBase64) {
@@ -89727,9 +89733,6 @@ async function maybeOpenSshTunnel(params, connectionUrl, defaultDbPort) {
   }
   const sshPort = Number(params[sshTunnelParameters.sshPort.slug] || "22") || 22;
   const sshPassphrase = params[sshTunnelParameters.sshPassphrase.slug];
-  const url = new URL(connectionUrl);
-  const dbHost = url.hostname;
-  const dbPort = url.port ? Number(url.port) : defaultDbPort;
   const [{ Client: Client2 }, net] = await Promise.all([
     Promise.resolve().then(() => __toESM(require_lib3(), 1)),
     import("net")
@@ -89772,16 +89775,29 @@ async function maybeOpenSshTunnel(params, connectionUrl, defaultDbPort) {
     sshClient.end();
     throw new Error("Failed to allocate local port for SSH tunnel.");
   }
-  url.hostname = "127.0.0.1";
-  url.port = String(address.port);
   return {
-    connectionUrl: url.toString(),
+    host: "127.0.0.1",
+    port: address.port,
     close: async () => {
       await new Promise((resolve) => server.close(() => resolve()));
       sshClient.end();
     }
   };
 }
+async function maybeOpenSshTunnel(params, connectionUrl, defaultDbPort) {
+  const sshHost = params[sshTunnelParameters.sshHost.slug];
+  if (!sshHost) return NOOP_TUNNEL(connectionUrl);
+  const url = new URL(connectionUrl);
+  const dbHost = url.hostname;
+  const dbPort = url.port ? Number(url.port) : defaultDbPort;
+  const tunnel = await maybeOpenSshTunnelHostPort(params, dbHost, dbPort);
+  url.hostname = tunnel.host;
+  url.port = String(tunnel.port);
+  return {
+    connectionUrl: url.toString(),
+    close: tunnel.close
+  };
+}
 
 // ../connectors/src/connectors/postgresql/setup.ts
 var postgresqlOnboarding = new ConnectorOnboarding({
@@ -91923,9 +91939,16 @@ A Filter is an Expression. Leaves are \`Dimensions\`, \`Tags\`, or \`CostCategor
 
 ### Business Logic
 
-The business logic type for this connector is "typescript". The connector exposes resolved AWS credentials via \`connection(connectionId)\`; pass them to \`@aws-sdk/client-cost-explorer\` directly inside the handler. Do NOT read AWS credentials from environment variables.
+The business logic type for this connector is "typescript". The connector exposes resolved AWS credentials via \`connection(connectionId)\` (already typed as \`{ accessKeyId, secretAccessKey, region }\` \u2014 do NOT add an \`as\` cast). Pass them to \`@aws-sdk/client-cost-explorer\` directly inside the handler. Do NOT read AWS credentials from environment variables.
 
-#### Example
+#### Server logic slug naming
+
+When creating a server logic for this connector, the \`slug\` (file name) MUST be lowercase kebab-case or snake_case \u2014 only \`[a-z0-9-_]\` is allowed. camelCase and uppercase will fail validation.
+
+- OK: \`monthly-cost-trend\`, \`cost_by_service\`, \`top10-services\`
+- NG: \`monthlyCostTrend\`, \`MonthlyCostTrend\`, \`monthly cost trend\`
+
+#### Example (slug: \`monthly-cost-trend\`)
 
 \`\`\`ts
 import type { Context } from "hono";
@@ -92001,9 +92024,16 @@ Filter \u306F Expression \u3067\u3059\u3002\u30EA\u30FC\u30D5\u306F \`Dimensions
 
 ### Business Logic
 
-\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\`connection(connectionId)\` \u3067\u89E3\u6C7A\u6E08\u307F\u306E AWS \u8A8D\u8A3C\u60C5\u5831\u3092\u53D6\u5F97\u3057\u3001\`@aws-sdk/client-cost-explorer\` \u306B\u76F4\u63A5\u6E21\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u5229\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089 AWS \u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\`connection(connectionId)\` \u3067\u89E3\u6C7A\u6E08\u307F\u306E AWS \u8A8D\u8A3C\u60C5\u5831\uFF08\`{ accessKeyId, secretAccessKey, region }\` \u3068\u3057\u3066\u578B\u4ED8\u3051\u6E08\u307F \u2014 \`as\` \u30AD\u30E3\u30B9\u30C8\u306F\u4E0D\u8981\uFF09\u3092\u53D6\u5F97\u3057\u3001\`@aws-sdk/client-cost-explorer\` \u306B\u76F4\u63A5\u6E21\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u5229\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089 AWS \u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
 
-#### Example
+#### \u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u306E slug \u547D\u540D\u898F\u5247
+
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u7528\u306E\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u3059\u308B\u969B\u3001\`slug\`\uFF08\u30D5\u30A1\u30A4\u30EB\u540D\uFF09\u306F **\u5C0F\u6587\u5B57\u306E kebab-case \u307E\u305F\u306F snake_case** \u306B\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\u8A31\u5BB9\u6587\u5B57\u306F \`[a-z0-9-_]\` \u306E\u307F\uFF09\u3002camelCase \u3084\u5927\u6587\u5B57\u3092\u542B\u3080\u3068\u30D0\u30EA\u30C7\u30FC\u30B7\u30E7\u30F3\u30A8\u30E9\u30FC\u306B\u306A\u308A\u307E\u3059\u3002
+
+- OK: \`monthly-cost-trend\`\u3001\`cost_by_service\`\u3001\`top10-services\`
+- NG: \`monthlyCostTrend\`\u3001\`MonthlyCostTrend\`\u3001\`monthly cost trend\`
+
+#### Example\uFF08slug: \`monthly-cost-trend\`\uFF09
 
 \`\`\`ts
 import type { Context } from "hono";
@@ -111442,17 +111472,27 @@ async function importMssql() {
 }
 async function runMssqlQuery(parsed, sql, options = {}) {
   const sqlMod = await importMssql();
-  const config = toMssqlConfig(parsed, {
-    encrypt: options.forceEncrypt
-  });
-  const pool = new sqlMod.ConnectionPool(config);
-  await pool.connect();
+  const tunnel = options.tunnelParams ? await maybeOpenSshTunnelHostPort(
+    options.tunnelParams,
+    parsed.server,
+    parsed.port
+  ) : null;
   try {
-    const result = await pool.request().query(sql);
-    const recordset = result.recordset ?? [];
-    return { rows: recordset };
+    const tunneled = tunnel ? { ...parsed, server: tunnel.host, port: tunnel.port } : parsed;
+    const config = toMssqlConfig(tunneled, {
+      encrypt: options.forceEncrypt
+    });
+    const pool = new sqlMod.ConnectionPool(config);
+    await pool.connect();
+    try {
+      const result = await pool.request().query(sql);
+      const recordset = result.recordset ?? [];
+      return { rows: recordset };
+    } finally {
+      await pool.close();
+    }
   } finally {
-    await pool.close();
+    await tunnel?.close();
   }
 }
 async function checkMssqlConnection(url, credentials, options = {}) {
@@ -111540,35 +111580,69 @@ function parseOracleJdbcUrl(jdbcUrl, options = {}) {
 function redactOracleUrl(jdbcUrl) {
   return jdbcUrl.replace(/(:\/\/)([^@/]+)@/, "$1***@").replace(/(thin:)([^@]+)@/i, "$1***@");
 }
+function parseOracleConnectStringHostPort(connectString) {
+  const m4 = /^([^:/]+):(\d+)(.*)$/.exec(connectString);
+  if (!m4) return null;
+  return { host: m4[1], port: Number(m4[2]), trailing: m4[3] };
+}
+function rewriteOracleConnectStringHostPort(connectString, host, port) {
+  const parts = parseOracleConnectStringHostPort(connectString);
+  if (!parts) return connectString;
+  return `${host}:${port}${parts.trailing}`;
+}
 
 // ../connectors/src/lib/oracle-runner.ts
 async function importOracleDb() {
   const mod = await import("oracledb");
   return mod.default ?? mod;
 }
-async function runOracleQuery(parsed, sql) {
+async function runOracleQuery(parsed, sql, options = {}) {
   const oracledb = await importOracleDb();
-  const connection = await oracledb.getConnection({
-    user: parsed.user,
-    password: parsed.password,
-    connectString: parsed.connectString
-  });
+  let tunnel = null;
+  if (options.tunnelParams) {
+    const hostPort = parseOracleConnectStringHostPort(parsed.connectString);
+    if (hostPort) {
+      tunnel = await maybeOpenSshTunnelHostPort(
+        options.tunnelParams,
+        hostPort.host,
+        hostPort.port
+      );
+    }
+  }
   try {
-    const result = await connection.execute(sql, [], {
-      outFormat: oracledb.OUT_FORMAT_OBJECT,
-      // Bound by the connector's own row cap, but keep the driver from
-      // streaming arbitrarily large result sets.
-      maxRows: 5e3
+    const connectString = tunnel ? rewriteOracleConnectStringHostPort(
+      parsed.connectString,
+      tunnel.host,
+      tunnel.port
+    ) : parsed.connectString;
+    const connection = await oracledb.getConnection({
+      user: parsed.user,
+      password: parsed.password,
+      connectString
     });
-    return { rows: result.rows ?? [] };
-  } finally {
     try {
-      await connection.close();
-    } catch {
+      const result = await connection.execute(
+        sql,
+        [],
+        {
+          outFormat: oracledb.OUT_FORMAT_OBJECT,
+          // Bound by the connector's own row cap, but keep the driver from
+          // streaming arbitrarily large result sets.
+          maxRows: 5e3
+        }
+      );
+      return { rows: result.rows ?? [] };
+    } finally {
+      try {
+        await connection.close();
+      } catch {
+      }
     }
+  } finally {
+    await tunnel?.close();
   }
 }
-async function checkOracleConnection(url, credentials) {
+async function checkOracleConnection(url, credentials, options = {}) {
   let parsed;
   try {
     parsed = parseOracleJdbcUrl(url, credentials);
@@ -111579,7 +111653,7 @@ async function checkOracleConnection(url, credentials) {
     };
   }
   try {
-    await runOracleQuery(parsed, "SELECT 1 FROM DUAL");
+    await runOracleQuery(parsed, "SELECT 1 FROM DUAL", options);
     return { success: true };
   } catch (err) {
     let msg = err instanceof Error ? err.message : String(err);
@@ -111789,12 +111863,13 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
       };
     }
     try {
+      const tunnelParams = connectionParamsToRecord(connection);
       if (parsed.driver === "sqlserver") {
         const mssqlParsed = parseSqlServerJdbcUrl(parsed.originalUrl, {
           username,
           password
         });
-        const result = await runMssqlQuery(mssqlParsed, sql);
+        const result = await runMssqlQuery(mssqlParsed, sql, { tunnelParams });
         const rows = result.rows;
         return {
           success: true,
@@ -111809,7 +111884,9 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
           password
         });
         const cleanSql = sql.replace(/;\s*$/, "");
-        const result = await runOracleQuery(oracleParsed, cleanSql);
+        const result = await runOracleQuery(oracleParsed, cleanSql, {
+          tunnelParams
+        });
         const rows = result.rows;
         return {
           success: true,
@@ -111821,7 +111898,7 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
       let tunnel;
       try {
         tunnel = await maybeOpenSshTunnel(
-          connectionParamsToRecord(connection),
+          tunnelParams,
           parsed.nativeUrl,
           parsed.defaultPort
         );
@@ -111995,10 +112072,18 @@ JDBC URL \u306E\u30D7\u30EC\u30D5\u30A3\u30C3\u30AF\u30B9\u306B\u3088\u308A\u65B
       };
     }
     if (parsed.driver === "sqlserver") {
-      return checkMssqlConnection(parsed.originalUrl, { username, password });
+      return checkMssqlConnection(
+        parsed.originalUrl,
+        { username, password },
+        { tunnelParams: params }
+      );
     }
     if (parsed.driver === "oracle") {
-      return checkOracleConnection(parsed.originalUrl, { username, password });
+      return checkOracleConnection(
+        parsed.originalUrl,
+        { username, password },
+        { tunnelParams: params }
+      );
     }
     const tunnel = await maybeOpenSshTunnel(
       params,
@@ -112055,10 +112140,12 @@ JDBC URL \u306E\u30D7\u30EC\u30D5\u30A3\u30C3\u30AF\u30B9\u306B\u3088\u308A\u65B
       });
       const sample = unwrapSampleLimit(sql);
       if (sample) {
-        const result = await runMssqlQuery(mssqlParsed, sample.inner);
+        const result = await runMssqlQuery(mssqlParsed, sample.inner, {
+          tunnelParams: params
+        });
         return { rows: result.rows.slice(0, sample.limit) };
       }
-      return runMssqlQuery(mssqlParsed, sql);
+      return runMssqlQuery(mssqlParsed, sql, { tunnelParams: params });
     }
     if (parsed.driver === "oracle") {
       const oracleParsed = parseOracleJdbcUrl(parsed.originalUrl, {
@@ -112068,11 +112155,13 @@ JDBC URL \u306E\u30D7\u30EC\u30D5\u30A3\u30C3\u30AF\u30B9\u306B\u3088\u308A\u65B
       const sample = unwrapSampleLimit(sql);
       if (sample) {
         const inner = sample.inner.replace(/;\s*$/, "");
-        const result = await runOracleQuery(oracleParsed, inner);
+        const result = await runOracleQuery(oracleParsed, inner, {
+          tunnelParams: params
+        });
         return { rows: result.rows.slice(0, sample.limit) };
       }
       const cleanSql = sql.replace(/;\s*$/, "");
-      return runOracleQuery(oracleParsed, cleanSql);
+      return runOracleQuery(oracleParsed, cleanSql, { tunnelParams: params });
     }
     const tunnel = await maybeOpenSshTunnel(
       params,
@@ -112304,16 +112393,18 @@ var semrushOnboarding = new ConnectorOnboarding({
 - Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`
   },
   dataOverviewInstructions: {
-    en: `1. Call ${requestToolName12} with path "/" and queryParams \`{ "type": "domain_overview", "domain": "<example.com>", "database": "us" }\` to inspect the domain overview report (CSV)
+    en: `1. Call ${requestToolName12} with path "/" and queryParams \`{ "type": "domain_ranks", "domain": "<example.com>", "database": "us" }\` to inspect the domain summary report (single-row CSV: rank, organic/paid keywords, traffic, cost)
 2. Call ${requestToolName12} with path "/" and queryParams \`{ "type": "domain_organic", "domain": "<example.com>", "database": "us", "display_limit": "5" }\` to sample organic keywords
 3. Call ${requestToolName12} with path "/" and queryParams \`{ "type": "phrase_this", "phrase": "<keyword>", "database": "us" }\` to inspect a keyword overview
-4. Explore other report types (backlinks_overview, domain_adwords, phrase_related) and the Trends API ("/analytics/v1/...") with responseFormat="json" as needed
-5. Remember: the Standard Analytics API returns semicolon-separated CSV with the first row as the header`,
-    ja: `1. ${requestToolName12} \u3067 path "/" \u3068 queryParams \`{ "type": "domain_overview", "domain": "<example.com>", "database": "us" }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30C9\u30E1\u30A4\u30F3\u30AA\u30FC\u30D0\u30FC\u30D3\u30E5\u30FC\uFF08CSV\uFF09\u3092\u78BA\u8A8D
+4. Optionally call ${requestToolName12} with path "/analytics/v1/" and queryParams \`{ "type": "backlinks_overview", "target": "<example.com>", "target_type": "root_domain" }\` to inspect a backlinks summary (returns semicolon-separated CSV \u2014 keep \`responseFormat="text"\`)
+5. Always pass an explicit small \`display_limit\` (e.g. \`"5"\`) \u2014 never rely on the default 10000, which can trip \`ERROR 132\` even when units remain
+6. Remember: the Standard Analytics API and the \`/analytics/v1/?type=backlinks_*\` Backlinks endpoints both return semicolon-separated CSV with the first row as the header`,
+    ja: `1. ${requestToolName12} \u3067 path "/" \u3068 queryParams \`{ "type": "domain_ranks", "domain": "<example.com>", "database": "us" }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30C9\u30E1\u30A4\u30F3\u30B5\u30DE\u30EA\u30FC\u30EC\u30DD\u30FC\u30C8\uFF08rank\u30FB\u30AA\u30FC\u30AC\u30CB\u30C3\u30AF/\u6709\u6599\u30AD\u30FC\u30EF\u30FC\u30C9\u30FB\u30C8\u30E9\u30D5\u30A3\u30C3\u30AF\u30FB\u30B3\u30B9\u30C8\u7B49\u306E1\u884CCSV\uFF09\u3092\u78BA\u8A8D
 2. ${requestToolName12} \u3067 path "/" \u3068 queryParams \`{ "type": "domain_organic", "domain": "<example.com>", "database": "us", "display_limit": "5" }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30AA\u30FC\u30AC\u30CB\u30C3\u30AF\u30AD\u30FC\u30EF\u30FC\u30C9\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
 3. ${requestToolName12} \u3067 path "/" \u3068 queryParams \`{ "type": "phrase_this", "phrase": "<keyword>", "database": "us" }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30AD\u30FC\u30EF\u30FC\u30C9\u6982\u8981\u3092\u78BA\u8A8D
-4. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u4ED6\u306E\u30EC\u30DD\u30FC\u30C8\u30BF\u30A4\u30D7\uFF08backlinks_overview\u3001domain_adwords\u3001phrase_related\uFF09\u3084 Trends API ("/analytics/v1/...", responseFormat="json") \u3092\u63A2\u7D22
-5. \u6CE8\u610F: Standard Analytics API \u306F\u30BB\u30DF\u30B3\u30ED\u30F3\u533A\u5207\u308ACSV\u3092\u8FD4\u3057\u30011\u884C\u76EE\u304C\u30D8\u30C3\u30C0\u30FC`
+4. \u5FC5\u8981\u306B\u5FDC\u3058\u3066 ${requestToolName12} \u3067 path "/analytics/v1/" \u3068 queryParams \`{ "type": "backlinks_overview", "target": "<example.com>", "target_type": "root_domain" }\` \u3092\u547C\u3073\u51FA\u3057\u3066\u30D0\u30C3\u30AF\u30EA\u30F3\u30AF\u30B5\u30DE\u30EA\u30FC\u3092\u78BA\u8A8D\uFF08\u30BB\u30DF\u30B3\u30ED\u30F3\u533A\u5207\u308ACSV\u3092\u8FD4\u3059\u305F\u3081 \`responseFormat="text"\` \u306E\u307E\u307E\uFF09
+5. \`display_limit\` \u306F\u5FC5\u305A\u660E\u793A\u7684\u306B\u5C0F\u3055\u3044\u5024\uFF08\u4F8B: \`"5"\`\uFF09\u3092\u6307\u5B9A\u3059\u308B\u3053\u3068\u3002\u30C7\u30D5\u30A9\u30EB\u30C810000\u306E\u307E\u307E\u3060\u3068\u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u304C\u3042\u3063\u3066\u3082 \`ERROR 132\` \u3067\u62D2\u5426\u3055\u308C\u308B\u3053\u3068\u304C\u3042\u308B
+6. \u6CE8\u610F: Standard Analytics API \u304A\u3088\u3073 \`/analytics/v1/?type=backlinks_*\` \u306E\u30D0\u30C3\u30AF\u30EA\u30F3\u30AF\u7CFB\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306F\u3069\u3061\u3089\u3082\u30BB\u30DF\u30B3\u30ED\u30F3\u533A\u5207\u308ACSV\uFF081\u884C\u76EE\u304C\u30D8\u30C3\u30C0\u30FC\uFF09\u3092\u8FD4\u3059`
   }
 });
 
@@ -112340,10 +112431,19 @@ The business logic type for this connector is "typescript". Write handler code u
 
 SDK methods (client created via \`connection(connectionId)\`):
 - \`client.request(path, init?)\` \u2014 low-level authenticated fetch. Pass \`init.query\` to set query parameters; \`key\` is injected automatically
-- \`client.report(type, query?)\` \u2014 call a Standard Analytics report and parse the CSV into \`{ columns, rows, raw }\`
+- \`client.checkUnits()\` \u2014 return the current API unit balance as a number. **FREE \u2014 does not consume units.** Use as a pre-flight before \`report()\`
+- \`client.report(type, query?)\` \u2014 call a Standard Analytics report and parse the CSV into \`{ columns: string[], rows: Record<string, string>[], raw: string }\`. Throws \`API UNITS BALANCE IS ZERO\` when the account is out of units
 - \`client.trends(path, query?)\` \u2014 call a Trends API endpoint (\`/analytics/v1/...\`) and return parsed JSON
 - \`client.projects(path, init?)\` \u2014 call a Projects API endpoint (\`/management/v1/...\`) and return parsed JSON
 
+\u{1F6A8} **MANDATORY pre-flight before creating any server logic that calls \`report()\`.** Before authoring a TypeScript handler that invokes \`client.report(...)\` (Standard Analytics \u2014 \`domain_ranks\`, \`domain_organic\`, \`phrase_this\`, etc.), you MUST first call the \`semrush-api-key_request\` tool with \`path: "https://www.semrush.com/users/countapiunits.html"\`, no \`queryParams\`, \`responseFormat: "text"\` to confirm the unit balance is greater than 0. If the balance is 0, **stop, do not create the server logic**, and report the issue to the user (the account owner needs to top up API units in the Semrush console). \`testFetchServerLogic\` will execute the handler and consume units; creating handlers when the balance is 0 produces \`ERROR 132 :: API UNITS BALANCE IS ZERO\` failures across every server logic.
+
+\u{1F6A8} **Always set a small \`display_limit\` explicitly \u2014 never rely on the default.** Semrush computes "required units = display_limit \xD7 per-row cost" up front, and rejects the request with \`ERROR 132 :: API UNITS BALANCE IS ZERO\` when the *estimated* cost exceeds the remaining balance, **even when the actual balance is non-zero** (e.g. balance \u2248 40,950 still fails for \`display_limit=10000\` on costly reports). Default to \`display_limit: "1000"\` (or smaller \u2014 \`"100"\` is plenty for most dashboards), and only increase it when the user explicitly asks for a larger sample AND \`checkUnits()\` confirms enough headroom. If you truly need all rows, paginate with \`display_offset\` in chunks of 1000 instead of bumping \`display_limit\`. Treat \`ERROR 132\` as "request too large for the current balance" first, and only as "balance is literally zero" after re-checking units.
+
+\u{1F6AB} **Do NOT use the Trends API (\`client.trends\`) or Projects API (\`client.projects\`) unless the user explicitly requests them.** These APIs require separate paid subscriptions (Trends and Projects/Management) that not every Semrush account has. Calls without the corresponding subscription fail with an authorization error. Default to the Standard Analytics API (\`client.report\`) for all SEO/keyword/backlink/competitor analysis. Only reach for \`trends()\` / \`projects()\` when the user explicitly mentions Trends data (traffic analytics, market explorer, etc.) or Projects (site audit, position tracking, etc.) \u2014 and confirm the user has the subscription before building the server logic.
+
+\u26A0\uFE0F **Important: \`report()\` row shape.** \`rows\` is \`Record<string, string>[]\` \u2014 each row is an object keyed by the CSV column NAME (matching \`columns\`), NOT a positional array. Access fields with \`row["Url"]\`, \`row["Keyword"]\`, \`row["Search Volume"]\` (column names may contain spaces). Do NOT use \`columns.indexOf("Url")\` and then \`row[index]\` \u2014 that returns \`undefined\` and silently produces empty results when combined with \`?? ""\` or \`Number(...) || 0\`. All values are strings; convert numeric columns with \`Number(row["Position"])\`.
+
 \`\`\`ts
 import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/semrush";
@@ -112356,9 +112456,25 @@ export default async function handler(c: Context) {
     database?: string;
   }>();
 
-  const overview = await semrush.report("domain_overview", { domain, database });
+  const result = await semrush.report("domain_organic", {
+    domain,
+    database,
+    display_limit: "100",
+  });
+
+  // \u2705 Correct: access by column name
+  const rows = result.rows.map((row) => ({
+    keyword: row["Keyword"],
+    position: Number(row["Position"]) || 0,
+    searchVolume: Number(row["Search Volume"]) || 0,
+    url: row["Url"] ?? "",
+  }));
 
-  return c.json({ columns: overview.columns, rows: overview.rows });
+  // \u274C Wrong: do NOT do this \u2014 row[index] is undefined because rows are objects, not arrays
+  // const urlIdx = result.columns.indexOf("Url");
+  // const url = (row as unknown as string[])[urlIdx];
+
+  return c.json({ columns: result.columns, rows });
 }
 \`\`\`
 
@@ -112370,8 +112486,8 @@ export default async function handler(c: Context) {
 
 Authentication: API key passed as the \`key\` query parameter on every request (handled automatically).
 
-#### Common Standard Analytics report types
-- \`domain_overview\` \u2014 domain summary (organic/paid traffic, keywords, backlinks)
+#### Common Standard Analytics report types (path \`/\`, returns CSV)
+- \`domain_ranks\` \u2014 single-row domain summary (rank, organic/paid keywords, traffic, cost). **There is no \`domain_overview\` type \u2014 use \`domain_ranks\`.**
 - \`domain_organic\` \u2014 organic keywords for a domain
 - \`domain_adwords\` \u2014 paid keywords for a domain
 - \`domain_organic_organic\` / \`domain_adwords_adwords\` \u2014 organic / paid competitors
@@ -112380,10 +112496,13 @@ Authentication: API key passed as the \`key\` query parameter on every request (
 - \`phrase_fullsearch\` \u2014 full-text keyword research
 - \`phrase_questions\` \u2014 question keywords
 - \`phrase_kdi\` \u2014 keyword difficulty index
+- \`url_organic\` / \`url_adwords\` \u2014 keywords ranking for a specific URL
+
+#### Backlinks API report types (path \`/analytics/v1/\`, also returns **CSV** \u2014 not JSON)
+Backlinks endpoints live under \`/analytics/v1/?type=backlinks_*\` and require \`target\` + \`target_type\` (\`root_domain\` | \`domain\` | \`url\`) instead of \`domain\`/\`database\`. They return semicolon-separated CSV, so use \`responseFormat="text"\` from the request tool, and from the SDK use \`client.request("/analytics/v1/", { query: { type: "backlinks_overview", target, target_type: "root_domain" } })\` and parse the CSV yourself \u2014 \`client.trends()\` will throw because it JSON-parses the body.
 - \`backlinks_overview\` \u2014 backlinks summary
 - \`backlinks\` \u2014 list of backlinks
 - \`backlinks_refdomains\` \u2014 referring domains
-- \`url_organic\` / \`url_adwords\` \u2014 keywords ranking for a specific URL
 
 To check remaining API units (free, does NOT consume units), call the request tool with an absolute URL: \`path: "https://www.semrush.com/users/countapiunits.html"\`, no query params, \`responseFormat: "text"\`. The response body is just a number.
 
@@ -112391,7 +112510,7 @@ To check remaining API units (free, does NOT consume units), call the request to
 - \`type\` \u2014 report type (required for the Standard API)
 - \`domain\` / \`phrase\` / \`url\` \u2014 entity to query
 - \`database\` \u2014 regional database (e.g. \`us\`, \`uk\`, \`de\`, \`fr\`, \`jp\`, \`br\`); required for most reports
-- \`display_limit\` \u2014 page size (default 10000, max 100000 depending on report)
+- \`display_limit\` \u2014 page size (default 10000, max 100000 depending on report). **Do NOT use the default \u2014 always pass an explicit small value like \`"1000"\`.** Large limits make Semrush pre-charge required units and reject with \`ERROR 132\` even when the balance is non-zero.
 - \`display_offset\` \u2014 pagination offset
 - \`display_date\` \u2014 historical date in \`YYYYMM15\` format (always day 15)
 - \`export_columns\` \u2014 comma-separated columns to return (e.g. \`Ph,Po,Nq,Cp\`)
@@ -112402,6 +112521,7 @@ To check remaining API units (free, does NOT consume units), call the request to
 - Each Standard Analytics report consumes API units; check the unit balance via \`https://www.semrush.com/users/countapiunits.html?key=...\` (free) first if you suspect a quota issue
 - The CSV separator is \`;\` (semicolon), NOT \`,\`. Some cells may contain commas inside them.
 - An HTTP 200 response with a body starting with \`ERROR\` indicates an API error (auth, parameters, or quota)
+- \`ERROR 132 :: API UNITS BALANCE IS ZERO\` does NOT only mean the balance is literally 0. Semrush also returns it when \`display_limit \xD7 per-row cost\` exceeds the remaining balance. Re-check the balance with \`countapiunits.html\` and lower \`display_limit\` (e.g. to \`1000\` or \`100\`) before assuming the account is empty.
 - The Trends API requires a separate Trends subscription; calls without it will fail with an authorization error
 - Date strings in historical endpoints must be the 15th of the month (\`YYYYMM15\`)`,
     ja: `### \u30C4\u30FC\u30EB
@@ -112414,10 +112534,19 @@ To check remaining API units (free, does NOT consume units), call the request to
 
 SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
 - \`client.request(path, init?)\` \u2014 \u8A8D\u8A3C\u4ED8\u304D\u306E\u4F4E\u30EC\u30D9\u30EBfetch\u3002\`init.query\` \u3067\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u6307\u5B9A\u3002\`key\` \u306F\u81EA\u52D5\u4ED8\u4E0E
-- \`client.report(type, query?)\` \u2014 Standard Analytics \u306E\u30EC\u30DD\u30FC\u30C8\u3092\u547C\u3073\u51FA\u3057\u3001CSV\u3092 \`{ columns, rows, raw }\` \u306B\u30D1\u30FC\u30B9
+- \`client.checkUnits()\` \u2014 \u73FE\u5728\u306E API \u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u3092\u6570\u5024\u3067\u8FD4\u3059\u3002**\u7121\u6599\u3067\u3001\u30E6\u30CB\u30C3\u30C8\u3092\u6D88\u8CBB\u3057\u306A\u3044\u3002** \`report()\` \u5B9F\u884C\u524D\u306E\u30D7\u30EA\u30D5\u30E9\u30A4\u30C8\u306B\u4F7F\u3046
+- \`client.report(type, query?)\` \u2014 Standard Analytics \u306E\u30EC\u30DD\u30FC\u30C8\u3092\u547C\u3073\u51FA\u3057\u3001CSV\u3092 \`{ columns: string[], rows: Record<string, string>[], raw: string }\` \u306B\u30D1\u30FC\u30B9\u3002\u6B8B\u91CF\u30BC\u30ED\u306E\u5834\u5408\u306F \`API UNITS BALANCE IS ZERO\` \u3092\u542B\u3080\u30A8\u30E9\u30FC\u3092 throw
 - \`client.trends(path, query?)\` \u2014 Trends API \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\`/analytics/v1/...\`\uFF09\u3092\u547C\u3073\u51FA\u3057 JSON \u3092\u8FD4\u3059
 - \`client.projects(path, init?)\` \u2014 Projects API \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\`/management/v1/...\`\uFF09\u3092\u547C\u3073\u51FA\u3057 JSON \u3092\u8FD4\u3059
 
+\u{1F6A8} **\`report()\` \u3092\u547C\u3076\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u3059\u308B\u524D\u306E\u5FC5\u9808\u30D7\u30EA\u30D5\u30E9\u30A4\u30C8\u3002** Standard Analytics\uFF08\`domain_ranks\`\u3001\`domain_organic\`\u3001\`phrase_this\` \u306A\u3069\uFF09\u306E \`client.report(...)\` \u3092\u542B\u3080 TypeScript \u30CF\u30F3\u30C9\u30E9\u3092\u4F5C\u6210\u3059\u308B\u524D\u306B\u3001\u5FC5\u305A \`semrush-api-key_request\` \u30C4\u30FC\u30EB\u3092 \`path: "https://www.semrush.com/users/countapiunits.html"\`\u3001\`queryParams\` \u7121\u3057\u3001\`responseFormat: "text"\` \u3067\u547C\u3073\u51FA\u3057\u3066\u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u304C 0 \u3088\u308A\u5927\u304D\u3044\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\u3053\u3068\u3002\u6B8B\u91CF\u304C 0 \u306E\u5834\u5408\u306F **\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u305B\u305A\u306B\u505C\u6B62\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u306B\u5831\u544A**\u3059\u308B\uFF08Semrush \u306E\u7BA1\u7406\u30B3\u30F3\u30BD\u30FC\u30EB\u304B\u3089 API \u30E6\u30CB\u30C3\u30C8\u3092\u88DC\u5145\u3059\u308B\u5FC5\u8981\u304C\u3042\u308B\uFF09\u3002\`testFetchServerLogic\` \u306F\u30CF\u30F3\u30C9\u30E9\u3092\u5B9F\u884C\u3057\u3066\u30E6\u30CB\u30C3\u30C8\u3092\u6D88\u8CBB\u3059\u308B\u305F\u3081\u3001\u6B8B\u91CF 0 \u306E\u307E\u307E\u4F5C\u6210\u3059\u308B\u3068\u5168\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u304C \`ERROR 132 :: API UNITS BALANCE IS ZERO\` \u3067\u5931\u6557\u3059\u308B\u3002
+
+\u{1F6A8} **\`display_limit\` \u306F\u5FC5\u305A\u660E\u793A\u7684\u306B\u5C0F\u3055\u3044\u5024\u3092\u6307\u5B9A\u3057\u3001\u30C7\u30D5\u30A9\u30EB\u30C8\u306B\u983C\u3089\u306A\u3044\u3053\u3068\u3002** Semrush \u306F\u4E8B\u524D\u306B\u300C\u5FC5\u8981\u30E6\u30CB\u30C3\u30C8 = display_limit \xD7 \u884C\u3042\u305F\u308A\u5358\u4FA1\u300D\u3092\u8A08\u7B97\u3057\u3001\u305D\u306E**\u898B\u7A4D\u984D**\u304C\u6B8B\u91CF\u3092\u8D85\u3048\u308B\u3068\u30EA\u30AF\u30A8\u30B9\u30C8\u3092 \`ERROR 132 :: API UNITS BALANCE IS ZERO\` \u3067\u62D2\u5426\u3059\u308B\u3002**\u5B9F\u6B8B\u91CF\u304C\u30BC\u30ED\u3067\u306A\u304F\u3066\u3082**\u8D77\u3053\u308B\uFF08\u4F8B\uFF1A\u6B8B\u91CF\u7D04 40,950 \u3067\u3082\u3001\u30B3\u30B9\u30C8\u306E\u9AD8\u3044\u30EC\u30DD\u30FC\u30C8\u3067 \`display_limit=10000\` \u3060\u3068\u5931\u6557\u3059\u308B\uFF09\u3002\u539F\u5247\u3068\u3057\u3066 \`display_limit: "1000"\`\uFF08\u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u7528\u9014\u306A\u3089 \`"100"\` \u3067\u3082\u5341\u5206\uFF09\u3092\u6307\u5B9A\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u304C\u660E\u793A\u7684\u306B\u5927\u304D\u306A\u30B5\u30F3\u30D7\u30EB\u3092\u8981\u6C42\u3057\u3001\u304B\u3064 \`checkUnits()\` \u3067\u6B8B\u91CF\u306B\u5341\u5206\u306A\u4F59\u88D5\u304C\u3042\u308B\u3053\u3068\u3092\u78BA\u8A8D\u3067\u304D\u305F\u5834\u5408\u306E\u307F\u5897\u3084\u3059\u3002\u5168\u884C\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F \`display_limit\` \u3092\u4E0A\u3052\u308B\u306E\u3067\u306F\u306A\u304F\u3001\`display_offset\` \u3067 1000 \u4EF6\u523B\u307F\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u5B9F\u88C5\u3059\u308B\u3053\u3068\u3002\`ERROR 132\` \u306F\u300C\u6B8B\u91CF\u304C\u6587\u5B57\u901A\u308A\u30BC\u30ED\u300D\u3088\u308A\u5148\u306B\u300C\u73FE\u5728\u306E\u6B8B\u91CF\u306B\u5BFE\u3057\u3066\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5927\u304D\u3059\u304E\u308B\u300D\u3092\u7591\u3044\u3001\u30E6\u30CB\u30C3\u30C8\u3092\u518D\u78BA\u8A8D\u3057\u3066\u304B\u3089\u5224\u65AD\u3059\u308B\u3053\u3068\u3002
+
+\u{1F6AB} **Trends API\uFF08\`client.trends\`\uFF09\u3068 Projects API\uFF08\`client.projects\`\uFF09\u306F\u3001\u30E6\u30FC\u30B6\u30FC\u304B\u3089\u660E\u793A\u7684\u306B\u6307\u793A\u3055\u308C\u306A\u3044\u9650\u308A\u4F7F\u7528\u3057\u306A\u3044\u3053\u3068\u3002** \u3053\u308C\u3089\u306E API \u306F\u5225\u9014\u6709\u6599\u30B5\u30D6\u30B9\u30AF\u30EA\u30D7\u30B7\u30E7\u30F3\uFF08Trends / Projects\uFF08Management\uFF09\uFF09\u304C\u5FC5\u8981\u3067\u3001\u3059\u3079\u3066\u306E Semrush \u30A2\u30AB\u30A6\u30F3\u30C8\u304C\u5951\u7D04\u3057\u3066\u3044\u308B\u308F\u3051\u3067\u306F\u306A\u3044\u3002\u30B5\u30D6\u30B9\u30AF\u30EA\u30D7\u30B7\u30E7\u30F3\u304C\u306A\u3044\u72B6\u614B\u3067\u547C\u3073\u51FA\u3059\u3068\u8A8D\u53EF\u30A8\u30E9\u30FC\u3067\u5931\u6557\u3059\u308B\u3002SEO\u30FB\u30AD\u30FC\u30EF\u30FC\u30C9\u30FB\u88AB\u30EA\u30F3\u30AF\u30FB\u7AF6\u5408\u5206\u6790\u306F\u539F\u5247 Standard Analytics API\uFF08\`client.report\`\uFF09\u3067\u884C\u3046\u3002\`trends()\` / \`projects()\` \u3092\u4F7F\u3046\u306E\u306F\u3001\u30E6\u30FC\u30B6\u30FC\u304C Trends \u30C7\u30FC\u30BF\uFF08\u30C8\u30E9\u30D5\u30A3\u30C3\u30AF\u30A2\u30CA\u30EA\u30C6\u30A3\u30AF\u30B9\u3001\u30DE\u30FC\u30B1\u30C3\u30C8\u30A8\u30AF\u30B9\u30D7\u30ED\u30FC\u30E9\u30FC\u7B49\uFF09\u307E\u305F\u306F Projects \u6A5F\u80FD\uFF08\u30B5\u30A4\u30C8\u76E3\u67FB\u3001\u30DD\u30B8\u30B7\u30E7\u30F3\u30C8\u30E9\u30C3\u30AD\u30F3\u30B0\u7B49\uFF09\u3092**\u660E\u793A\u7684\u306B\u6C42\u3081\u305F\u5834\u5408\u306E\u307F**\u3067\u3001\u305D\u306E\u969B\u3082\u30B5\u30D6\u30B9\u30AF\u30EA\u30D7\u30B7\u30E7\u30F3\u306E\u6709\u7121\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u78BA\u8A8D\u3057\u3066\u304B\u3089\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u3092\u4F5C\u6210\u3059\u308B\u3053\u3068\u3002
+
+\u26A0\uFE0F **\u91CD\u8981: \`report()\` \u306E\u884C\uFF08row\uFF09\u306E\u5F62\u72B6\u306B\u3064\u3044\u3066\u3002** \`rows\` \u306F \`Record<string, string>[]\` \u3067\u3059 \u2014 \u5404\u884C\u306F CSV \u306E\u30AB\u30E9\u30E0\u300C\u540D\u300D\uFF08\`columns\` \u3068\u4E00\u81F4\uFF09\u3092\u30AD\u30FC\u3068\u3057\u305F\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3067\u3042\u308A\u3001\u4F4D\u7F6E\u30A4\u30F3\u30C7\u30C3\u30AF\u30B9\u306E\u914D\u5217\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002\u30D5\u30A3\u30FC\u30EB\u30C9\u3078\u306E\u30A2\u30AF\u30BB\u30B9\u306F\u5FC5\u305A \`row["Url"]\`\u3001\`row["Keyword"]\`\u3001\`row["Search Volume"]\`\uFF08\u30AB\u30E9\u30E0\u540D\u306B\u30B9\u30DA\u30FC\u30B9\u3092\u542B\u3080\u3053\u3068\u3042\u308A\uFF09\u306E\u3088\u3046\u306B\u30AB\u30E9\u30E0\u540D\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002\`columns.indexOf("Url")\` \u3067\u30A4\u30F3\u30C7\u30C3\u30AF\u30B9\u3092\u53D6\u5F97\u3057\u3066\u304B\u3089 \`row[index]\` \u3067\u30A2\u30AF\u30BB\u30B9\u3057\u3066\u306F\u3044\u3051\u307E\u305B\u3093 \u2014 \u305D\u308C\u306F \`undefined\` \u3092\u8FD4\u3057\u3001\`?? ""\` \u3084 \`Number(...) || 0\` \u3068\u7D44\u307F\u5408\u308F\u3055\u308B\u3053\u3068\u3067\u7D50\u679C\u304C\u7A7A\u306B\u306A\u308B\u7121\u97F3\u306E\u5931\u6557\u3092\u751F\u307F\u307E\u3059\u3002\u5168\u3066\u306E\u5024\u306F\u6587\u5B57\u5217\u306A\u306E\u3067\u3001\u6570\u5024\u30AB\u30E9\u30E0\u306F \`Number(row["Position"])\` \u3067\u660E\u793A\u5909\u63DB\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+
 \`\`\`ts
 import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/semrush";
@@ -112430,9 +112559,25 @@ export default async function handler(c: Context) {
     database?: string;
   }>();
 
-  const overview = await semrush.report("domain_overview", { domain, database });
+  const result = await semrush.report("domain_organic", {
+    domain,
+    database,
+    display_limit: "100",
+  });
 
-  return c.json({ columns: overview.columns, rows: overview.rows });
+  // \u2705 \u6B63: \u30AB\u30E9\u30E0\u540D\u3067\u30A2\u30AF\u30BB\u30B9\u3059\u308B
+  const rows = result.rows.map((row) => ({
+    keyword: row["Keyword"],
+    position: Number(row["Position"]) || 0,
+    searchVolume: Number(row["Search Volume"]) || 0,
+    url: row["Url"] ?? "",
+  }));
+
+  // \u274C \u8AA4: \u884C\u306F\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3067\u3042\u308A\u914D\u5217\u3067\u306F\u306A\u3044\u305F\u3081 row[index] \u306F undefined \u306B\u306A\u308B
+  // const urlIdx = result.columns.indexOf("Url");
+  // const url = (row as unknown as string[])[urlIdx];
+
+  return c.json({ columns: result.columns, rows });
 }
 \`\`\`
 
@@ -112444,8 +112589,8 @@ export default async function handler(c: Context) {
 
 \u8A8D\u8A3C: API\u30AD\u30FC\u3092\u3059\u3079\u3066\u306E\u30EA\u30AF\u30A8\u30B9\u30C8\u306B \`key\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3068\u3057\u3066\u4ED8\u4E0E\uFF08\u81EA\u52D5\uFF09\u3002
 
-#### \u4E3B\u8981\u306A Standard Analytics \u30EC\u30DD\u30FC\u30C8\u30BF\u30A4\u30D7
-- \`domain_overview\` \u2014 \u30C9\u30E1\u30A4\u30F3\u306E\u30B5\u30DE\u30EA\u30FC\uFF08\u30AA\u30FC\u30AC\u30CB\u30C3\u30AF/\u6709\u6599\u30C8\u30E9\u30D5\u30A3\u30C3\u30AF\u3001\u30AD\u30FC\u30EF\u30FC\u30C9\u3001\u30D0\u30C3\u30AF\u30EA\u30F3\u30AF\uFF09
+#### \u4E3B\u8981\u306A Standard Analytics \u30EC\u30DD\u30FC\u30C8\u30BF\u30A4\u30D7\uFF08path \`/\`\u3001CSV\u3092\u8FD4\u3059\uFF09
+- \`domain_ranks\` \u2014 \u30C9\u30E1\u30A4\u30F3\u306E\u30B5\u30DE\u30EA\u30FC\uFF08rank\u3001\u30AA\u30FC\u30AC\u30CB\u30C3\u30AF/\u6709\u6599\u30AD\u30FC\u30EF\u30FC\u30C9\u6570\u3001\u30C8\u30E9\u30D5\u30A3\u30C3\u30AF\u3001\u30B3\u30B9\u30C8\u306E1\u884CCSV\uFF09\u3002**\`domain_overview\` \u3068\u3044\u3046\u30BF\u30A4\u30D7\u306F\u5B58\u5728\u3057\u306A\u3044\u3002\`domain_ranks\` \u3092\u4F7F\u3046\u3053\u3068\u3002**
 - \`domain_organic\` \u2014 \u30C9\u30E1\u30A4\u30F3\u306E\u30AA\u30FC\u30AC\u30CB\u30C3\u30AF\u30AD\u30FC\u30EF\u30FC\u30C9
 - \`domain_adwords\` \u2014 \u30C9\u30E1\u30A4\u30F3\u306E\u6709\u6599\u30AD\u30FC\u30EF\u30FC\u30C9
 - \`domain_organic_organic\` / \`domain_adwords_adwords\` \u2014 \u30AA\u30FC\u30AC\u30CB\u30C3\u30AF\uFF0F\u6709\u6599\u306E\u7AF6\u5408
@@ -112454,10 +112599,13 @@ export default async function handler(c: Context) {
 - \`phrase_fullsearch\` \u2014 \u30D5\u30EB\u30C6\u30AD\u30B9\u30C8\u30AD\u30FC\u30EF\u30FC\u30C9\u30EA\u30B5\u30FC\u30C1
 - \`phrase_questions\` \u2014 \u8CEA\u554F\u5F62\u5F0F\u30AD\u30FC\u30EF\u30FC\u30C9
 - \`phrase_kdi\` \u2014 \u30AD\u30FC\u30EF\u30FC\u30C9\u96E3\u6613\u5EA6\uFF08KDI\uFF09
+- \`url_organic\` / \`url_adwords\` \u2014 \u7279\u5B9AURL\u3067\u30E9\u30F3\u30AF\u30A4\u30F3\u3057\u3066\u3044\u308B\u30AD\u30FC\u30EF\u30FC\u30C9
+
+#### Backlinks API \u30EC\u30DD\u30FC\u30C8\u30BF\u30A4\u30D7\uFF08path \`/analytics/v1/\`\u3001\u3053\u3061\u3089\u3082 **CSV** \u3092\u8FD4\u3059\u3002JSON \u3067\u306F\u306A\u3044\uFF09
+Backlinks \u7CFB\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306F \`/analytics/v1/?type=backlinks_*\` \u914D\u4E0B\u306B\u3042\u308A\u3001\`domain\`/\`database\` \u3067\u306F\u306A\u304F \`target\` + \`target_type\`\uFF08\`root_domain\` | \`domain\` | \`url\`\uFF09\u3092\u8981\u6C42\u3059\u308B\u3002\u30EC\u30B9\u30DD\u30F3\u30B9\u306F\u30BB\u30DF\u30B3\u30ED\u30F3\u533A\u5207\u308ACSV\u306A\u306E\u3067\u3001request \u30C4\u30FC\u30EB\u3067\u306F \`responseFormat="text"\` \u3092\u4F7F\u3044\u3001SDK \u3067\u306F \`client.request("/analytics/v1/", { query: { type: "backlinks_overview", target, target_type: "root_domain" } })\` \u3092\u547C\u3093\u3067 CSV \u3092\u81EA\u524D\u3067\u30D1\u30FC\u30B9\u3059\u308B\u3053\u3068\u3002\`client.trends()\` \u306F JSON.parse \u3059\u308B\u305F\u3081 backlinks \u7CFB\u3067\u4F7F\u3046\u3068 throw \u3059\u308B\u3002
 - \`backlinks_overview\` \u2014 \u30D0\u30C3\u30AF\u30EA\u30F3\u30AF\u6982\u8981
 - \`backlinks\` \u2014 \u30D0\u30C3\u30AF\u30EA\u30F3\u30AF\u4E00\u89A7
 - \`backlinks_refdomains\` \u2014 \u53C2\u7167\u30C9\u30E1\u30A4\u30F3
-- \`url_organic\` / \`url_adwords\` \u2014 \u7279\u5B9AURL\u3067\u30E9\u30F3\u30AF\u30A4\u30F3\u3057\u3066\u3044\u308B\u30AD\u30FC\u30EF\u30FC\u30C9
 
 API \u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u306E\u78BA\u8A8D\uFF08\u7121\u6599\u3001\u30E6\u30CB\u30C3\u30C8\u3092\u6D88\u8CBB\u3057\u306A\u3044\uFF09\u306F request \u30C4\u30FC\u30EB\u306B\u7D76\u5BFEURL\u3092\u6E21\u3059: \`path: "https://www.semrush.com/users/countapiunits.html"\`\u3001queryParams \u306A\u3057\u3001\`responseFormat: "text"\`\u3002\u30EC\u30B9\u30DD\u30F3\u30B9\u672C\u6587\u306F\u6570\u5024\u306E\u307F\u3002
 
@@ -112465,7 +112613,7 @@ API \u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u306E\u78BA\u8A8D\uFF08\u7121\u6599\u30
 - \`type\` \u2014 \u30EC\u30DD\u30FC\u30C8\u7A2E\u5225\uFF08Standard API \u3067\u306F\u5FC5\u9808\uFF09
 - \`domain\` / \`phrase\` / \`url\` \u2014 \u30AF\u30A8\u30EA\u5BFE\u8C61\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3
 - \`database\` \u2014 \u5730\u57DF\u5225\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\uFF08\`us\`, \`uk\`, \`de\`, \`fr\`, \`jp\`, \`br\` \u306A\u3069\uFF09\u3002\u591A\u304F\u306E\u30EC\u30DD\u30FC\u30C8\u3067\u5FC5\u9808
-- \`display_limit\` \u2014 \u30DA\u30FC\u30B8\u30B5\u30A4\u30BA\uFF08\u30C7\u30D5\u30A9\u30EB\u30C810000\u3001\u30EC\u30DD\u30FC\u30C8\u306B\u3088\u3063\u3066\u306F\u6700\u5927100000\uFF09
+- \`display_limit\` \u2014 \u30DA\u30FC\u30B8\u30B5\u30A4\u30BA\uFF08\u30C7\u30D5\u30A9\u30EB\u30C810000\u3001\u30EC\u30DD\u30FC\u30C8\u306B\u3088\u3063\u3066\u306F\u6700\u5927100000\uFF09\u3002**\u30C7\u30D5\u30A9\u30EB\u30C8\u3092\u4F7F\u308F\u305A\u3001\u5FC5\u305A \`"1000"\` \u7A0B\u5EA6\u306E\u5C0F\u3055\u3044\u5024\u3092\u660E\u793A\u7684\u306B\u6307\u5B9A\u3059\u308B\u3053\u3068\u3002** \u5927\u304D\u3044\u5024\u3060\u3068 Semrush \u304C\u5FC5\u8981\u30E6\u30CB\u30C3\u30C8\u3092\u4E8B\u524D\u8A08\u7B97\u3057\u3001\u6B8B\u91CF\u304C\u3042\u3063\u3066\u3082 \`ERROR 132\` \u3067\u62D2\u5426\u3059\u308B\u3002
 - \`display_offset\` \u2014 \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u30AA\u30D5\u30BB\u30C3\u30C8
 - \`display_date\` \u2014 \u5C65\u6B74\u306E\u65E5\u4ED8\u3002\`YYYYMM15\` \u5F62\u5F0F\uFF08\u5FC5\u305A\u6708\u306E15\u65E5\uFF09
 - \`export_columns\` \u2014 \u8FD4\u5374\u30AB\u30E9\u30E0\u3092\u30AB\u30F3\u30DE\u533A\u5207\u308A\u3067\u6307\u5B9A\uFF08\u4F8B: \`Ph,Po,Nq,Cp\`\uFF09
@@ -112476,6 +112624,7 @@ API \u30E6\u30CB\u30C3\u30C8\u6B8B\u91CF\u306E\u78BA\u8A8D\uFF08\u7121\u6599\u30
 - Standard Analytics \u306E\u5404\u30EC\u30DD\u30FC\u30C8\u306F API \u30E6\u30CB\u30C3\u30C8\u3092\u6D88\u8CBB\u3059\u308B\u3002\u30AF\u30A9\u30FC\u30BF\u304C\u7591\u308F\u3057\u3044\u5834\u5408\u306F \`https://www.semrush.com/users/countapiunits.html?key=...\` \u3067\u6B8B\u91CF\u3092\u5148\u306B\u78BA\u8A8D\u3059\u308B\uFF08\u7121\u6599\uFF09
 - CSV \u306E\u30BB\u30D1\u30EC\u30FC\u30BF\u306F \`;\`\uFF08\u30BB\u30DF\u30B3\u30ED\u30F3\uFF09\u3067\u3042\u308A \`,\` \u3067\u306F\u306A\u3044\u3002\u30BB\u30EB\u5185\u306B\u30AB\u30F3\u30DE\u304C\u542B\u307E\u308C\u308B\u3053\u3068\u304C\u3042\u308B
 - HTTP 200 \u3067\u3082\u672C\u6587\u304C \`ERROR\` \u3067\u59CB\u307E\u308B\u5834\u5408\u306F API\u30A8\u30E9\u30FC\uFF08\u8A8D\u8A3C\u3001\u30D1\u30E9\u30E1\u30FC\u30BF\u3001\u30AF\u30A9\u30FC\u30BF\uFF09
+- \`ERROR 132 :: API UNITS BALANCE IS ZERO\` \u306F\u300C\u6B8B\u91CF\u304C\u6587\u5B57\u901A\u308A 0\u300D\u3060\u3051\u3092\u610F\u5473\u3059\u308B\u308F\u3051\u3067\u306F\u306A\u3044\u3002Semrush \u306F \`display_limit \xD7 \u884C\u3042\u305F\u308A\u5358\u4FA1\` \u304C\u6B8B\u91CF\u3092\u8D85\u3048\u308B\u5834\u5408\u3082\u540C\u3058\u30A8\u30E9\u30FC\u3092\u8FD4\u3059\u3002\`countapiunits.html\` \u3067\u6B8B\u91CF\u3092\u518D\u78BA\u8A8D\u3057\u3001\`display_limit\` \u3092 \`1000\` \u3084 \`100\` \u307E\u3067\u4E0B\u3052\u3066\u304B\u3089\u300C\u6B8B\u91CF\u5207\u308C\u300D\u3068\u5224\u65AD\u3059\u308B\u3053\u3068\u3002
 - Trends API \u306F\u5225\u9014 Trends \u30B5\u30D6\u30B9\u30AF\u30EA\u30D7\u30B7\u30E7\u30F3\u304C\u5FC5\u8981\u3002\u672A\u5951\u7D04\u3060\u3068\u8A8D\u53EF\u30A8\u30E9\u30FC\u306B\u306A\u308B
 - \u5C65\u6B74\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306E\u65E5\u4ED8\u306F\u5FC5\u305A\u6708\u306E15\u65E5\uFF08\`YYYYMM15\`\uFF09`
   },
@@ -113595,7 +113744,8 @@ var parameters72 = {
     type: "text",
     secret: true,
     required: false
-  })
+  }),
+  ...sshTunnelParameters
 };
 
 // ../connectors/src/connectors/sqlserver/tools/execute-query.ts
@@ -113654,7 +113804,9 @@ Avoid loading large amounts of data; always include \`TOP\` in queries.`,
       };
     }
     try {
-      const { rows } = await runMssqlQuery(parsed, sql);
+      const { rows } = await runMssqlQuery(parsed, sql, {
+        tunnelParams: connectionParamsToRecord(connection)
+      });
       const truncated = rows.length > MAX_ROWS14;
       return {
         success: true,
@@ -113725,7 +113877,8 @@ The business logic type for this connector is "sql".
       {
         username: params[parameters72.username.slug],
         password: params[parameters72.password.slug]
-      }
+      },
+      { tunnelParams: params }
     );
   },
   async query(params, sql, _namedParams) {
@@ -113735,10 +113888,12 @@ The business logic type for this connector is "sql".
     });
     const sample = unwrapSampleLimit(sql);
     if (sample) {
-      const result = await runMssqlQuery(parsed, sample.inner);
+      const result = await runMssqlQuery(parsed, sample.inner, {
+        tunnelParams: params
+      });
       return { rows: result.rows.slice(0, sample.limit) };
     }
-    return runMssqlQuery(parsed, sql);
+    return runMssqlQuery(parsed, sql, { tunnelParams: params });
   }
 });
 
@@ -113784,7 +113939,8 @@ var parameters73 = {
     type: "text",
     secret: true,
     required: false
-  })
+  }),
+  ...sshTunnelParameters
 };
 
 // ../connectors/src/connectors/azure-sql/tools/execute-query.ts
@@ -113843,7 +113999,10 @@ Avoid loading large amounts of data; always include \`TOP\` in queries.`,
       };
     }
     try {
-      const { rows } = await runMssqlQuery(parsed, sql, { forceEncrypt: true });
+      const { rows } = await runMssqlQuery(parsed, sql, {
+        forceEncrypt: true,
+        tunnelParams: connectionParamsToRecord(connection)
+      });
       const truncated = rows.length > MAX_ROWS15;
       return {
         success: true,
@@ -113868,7 +114027,7 @@ var azureSqlConnector = new ConnectorPlugin({
   description: "Connect to Azure SQL Database (managed) using a JDBC-style URL. Encryption is enforced automatically.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/5TL0yBbxoLlk6jFZuiHl8w/55040f52d57bf0b77a2215c985c5a772/azure-sql-icon.png",
   parameters: parameters73,
-  releaseFlag: { dev1: true, dev2: false, prod: false },
+  releaseFlag: { dev1: true, dev2: true, prod: true },
   categories: ["database"],
   onboarding: azureSqlOnboarding,
   systemPrompt: {
@@ -113915,7 +114074,7 @@ The business logic type for this connector is "sql".
         username: params[parameters73.username.slug],
         password: params[parameters73.password.slug]
       },
-      { forceEncrypt: true }
+      { forceEncrypt: true, tunnelParams: params }
     );
   },
   async query(params, sql, _namedParams) {
@@ -113926,11 +114085,353 @@ The business logic type for this connector is "sql".
     const sample = unwrapSampleLimit(sql);
     if (sample) {
       const result = await runMssqlQuery(parsed, sample.inner, {
-        forceEncrypt: true
+        forceEncrypt: true,
+        tunnelParams: params
       });
       return { rows: result.rows.slice(0, sample.limit) };
     }
-    return runMssqlQuery(parsed, sql, { forceEncrypt: true });
+    return runMssqlQuery(parsed, sql, {
+      forceEncrypt: true,
+      tunnelParams: params
+    });
+  }
+});
+
+// ../connectors/src/connectors/cosmosdb/setup.ts
+var cosmosdbOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Use cosmosdb_listContainers to list all containers in the configured database
+2. For key containers, sample documents with cosmosdb_query: container="users", sql="SELECT TOP 5 * FROM c"
+3. Examine the document structure to understand the schema (Cosmos DB containers are schema-flexible \u2014 items in the same container may have different fields)
+4. Use cosmosdb_query with GROUP BY to analyse data distribution if needed: \`SELECT c.status, COUNT(1) AS n FROM c GROUP BY c.status\``,
+    ja: `1. cosmosdb_listContainers \u3067\u5BFE\u8C61\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u5185\u306E\u30B3\u30F3\u30C6\u30CA\u4E00\u89A7\u3092\u53D6\u5F97
+2. \u4E3B\u8981\u30B3\u30F3\u30C6\u30CA\u306B\u3064\u3044\u3066 cosmosdb_query \u3067\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0: container="users", sql="SELECT TOP 5 * FROM c"
+3. \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u69CB\u9020\u3092\u78BA\u8A8D\u3057\u3066\u30B9\u30AD\u30FC\u30DE\u3092\u628A\u63E1\uFF08Cosmos DB \u306E\u30B3\u30F3\u30C6\u30CA\u306F\u30B9\u30AD\u30FC\u30DE\u304C\u67D4\u8EDF\u306A\u305F\u3081\u3001\u540C\u3058\u30B3\u30F3\u30C6\u30CA\u5185\u3067\u3082\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u30D5\u30A3\u30FC\u30EB\u30C9\u304C\u7570\u306A\u308B\u5834\u5408\u304C\u3042\u308A\u307E\u3059\uFF09
+4. \u5FC5\u8981\u306B\u5FDC\u3058\u3066 cosmosdb_query \u306E GROUP BY \u3067\u30C7\u30FC\u30BF\u5206\u5E03\u3092\u78BA\u8A8D: \`SELECT c.status, COUNT(1) AS n FROM c GROUP BY c.status\``
+  }
+});
+
+// ../connectors/src/connectors/cosmosdb/parameters.ts
+var parameters74 = {
+  endpoint: new ParameterDefinition({
+    slug: "endpoint",
+    name: "Cosmos DB Endpoint",
+    description: "Cosmos DB account endpoint URL (e.g. `https://<account>.documents.azure.com:443/`). Found in the Azure Portal under the account's *Keys* blade.",
+    envVarBaseKey: "COSMOSDB_ENDPOINT",
+    type: "text",
+    secret: false,
+    required: true
+  }),
+  key: new ParameterDefinition({
+    slug: "key",
+    name: "Account Key",
+    description: "Cosmos DB account key (primary or secondary master key). Use a read-only key when only querying data.",
+    envVarBaseKey: "COSMOSDB_KEY",
+    type: "text",
+    secret: true,
+    required: true
+  }),
+  database: new ParameterDefinition({
+    slug: "database",
+    name: "Database",
+    description: "The Cosmos DB database (a.k.a. database account namespace) to connect to.",
+    envVarBaseKey: "COSMOSDB_DATABASE",
+    type: "text",
+    secret: false,
+    required: true
+  })
+};
+
+// ../connectors/src/connectors/cosmosdb/tools/list-containers.ts
+import { z as z90 } from "zod";
+var inputSchema90 = z90.object({
+  toolUseIntent: z90.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z90.string().describe("ID of the Cosmos DB connection to use")
+});
+var outputSchema90 = z90.discriminatedUnion("success", [
+  z90.object({
+    success: z90.literal(true),
+    containers: z90.array(
+      z90.object({
+        id: z90.string(),
+        partitionKey: z90.array(z90.string()).optional()
+      })
+    )
+  }),
+  z90.object({
+    success: z90.literal(false),
+    error: z90.string()
+  })
+]);
+var listContainersTool = new ConnectorTool({
+  name: "listContainers",
+  description: `List all containers in the configured Cosmos DB database.
+Use this as the first step to explore the data structure. Returns container ids and their partition key paths.
+After listing containers, use the query tool to sample items and understand each container's schema.`,
+  inputSchema: inputSchema90,
+  outputSchema: outputSchema90,
+  async execute({ connectionId }, connections) {
+    const connection = connections.find((c6) => c6.id === connectionId);
+    if (!connection) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-query] cosmosdb/${connection.name}: listContainers`
+    );
+    let key;
+    try {
+      const { CosmosClient } = await import("@azure/cosmos");
+      const endpoint = parameters74.endpoint.getValue(connection);
+      key = parameters74.key.getValue(connection);
+      const database = parameters74.database.getValue(connection);
+      const client = new CosmosClient({ endpoint, key });
+      const db = client.database(database);
+      const { resources } = await db.containers.readAll().fetchAll();
+      return {
+        success: true,
+        containers: resources.map((c6) => ({
+          id: c6.id,
+          partitionKey: extractPartitionKeyPaths(c6.partitionKey)
+        }))
+      };
+    } catch (err) {
+      let msg = err instanceof Error ? err.message : String(err);
+      if (key) msg = msg.replaceAll(key, "***");
+      return { success: false, error: msg };
+    }
+  }
+});
+function extractPartitionKeyPaths(partitionKey) {
+  if (!partitionKey || typeof partitionKey !== "object") return void 0;
+  const paths = partitionKey.paths;
+  if (!Array.isArray(paths)) return void 0;
+  return paths.filter((p2) => typeof p2 === "string");
+}
+
+// ../connectors/src/connectors/cosmosdb/tools/query.ts
+import { z as z91 } from "zod";
+var MAX_DOCUMENTS3 = 500;
+var inputSchema91 = z91.object({
+  toolUseIntent: z91.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z91.string().describe("ID of the Cosmos DB connection to use"),
+  container: z91.string().describe("Id of the container (a.k.a. collection) to query"),
+  sql: z91.string().describe(
+    "Cosmos DB SQL query (Core / NoSQL API). Reference items via the alias `c` (e.g. `SELECT TOP 100 c.id, c.name FROM c WHERE c.status = 'active'`). Use `TOP n` rather than `LIMIT n` \u2014 Cosmos DB does not understand `LIMIT`."
+  ),
+  partitionKey: z91.string().optional().describe(
+    `Optional partition key value to scope the query to a single partition. Pass as a JSON-encoded scalar (e.g. '"abc"' or '123'). Omit for cross-partition queries.`
+  )
+});
+var outputSchema91 = z91.discriminatedUnion("success", [
+  z91.object({
+    success: z91.literal(true),
+    documentCount: z91.number(),
+    truncated: z91.boolean(),
+    requestCharge: z91.number().optional(),
+    documents: z91.array(z91.unknown())
+  }),
+  z91.object({
+    success: z91.literal(false),
+    error: z91.string()
+  })
+]);
+var queryTool = new ConnectorTool({
+  name: "query",
+  description: `Execute a Cosmos DB SQL (Core / NoSQL API) query against a container. Returns up to ${MAX_DOCUMENTS3} items.
+Use for: schema exploration, data sampling, aggregations, and analytical queries.
+Cosmos DB SQL targets a single container; reference items via the alias \`c\` (e.g. \`SELECT c.id FROM c WHERE c.userId = 'abc'\`).
+Use \`TOP n\` (not \`LIMIT n\`) to bound the result. Cross-partition queries are enabled by default \u2014 pass \`partitionKey\` to restrict to a single partition.`,
+  inputSchema: inputSchema91,
+  outputSchema: outputSchema91,
+  async execute({ connectionId, container, sql, partitionKey }, connections) {
+    const connection = connections.find((c6) => c6.id === connectionId);
+    if (!connection) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-query] cosmosdb/${connection.name} (${container}): ${sql}`
+    );
+    let key;
+    try {
+      const cosmos = await import("@azure/cosmos");
+      const { CosmosClient } = cosmos;
+      const endpoint = parameters74.endpoint.getValue(connection);
+      key = parameters74.key.getValue(connection);
+      const database = parameters74.database.getValue(connection);
+      const client = new CosmosClient({ endpoint, key });
+      const cont = client.database(database).container(container);
+      const queryOptions = {
+        // Bound by the connector's own row cap, but keep the SDK from
+        // streaming arbitrarily large continuations.
+        maxItemCount: MAX_DOCUMENTS3 + 1
+      };
+      if (partitionKey != null && partitionKey !== "") {
+        try {
+          queryOptions.partitionKey = JSON.parse(partitionKey);
+        } catch {
+          return {
+            success: false,
+            error: `Invalid partitionKey: must be a JSON-encoded scalar (e.g. '"abc"' or '123'). Got: ${partitionKey}`
+          };
+        }
+      }
+      const iterator = cont.items.query(sql, queryOptions);
+      const { resources, requestCharge } = await iterator.fetchNext();
+      const documents = resources ?? [];
+      const truncated = documents.length > MAX_DOCUMENTS3;
+      return {
+        success: true,
+        documentCount: Math.min(documents.length, MAX_DOCUMENTS3),
+        truncated,
+        requestCharge,
+        documents: documents.slice(0, MAX_DOCUMENTS3)
+      };
+    } catch (err) {
+      let msg = err instanceof Error ? err.message : String(err);
+      if (key) msg = msg.replaceAll(key, "***");
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/cosmosdb/index.ts
+var tools74 = {
+  listContainers: listContainersTool,
+  query: queryTool
+};
+var cosmosdbConnector = new ConnectorPlugin({
+  slug: "cosmosdb",
+  authType: AUTH_TYPES.USER_PASSWORD,
+  name: "Azure Cosmos DB",
+  description: "Connect to Azure Cosmos DB (Core / NoSQL API) for document-oriented data storage and SQL-style querying.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/5p9B2Db0V2d8mK2jgBWtZu/dad72db8f41b16c50de2bcef03f9d415/cosmosdb-icon.png",
+  parameters: parameters74,
+  releaseFlag: { dev1: true, dev2: true, prod: true },
+  categories: ["database"],
+  onboarding: cosmosdbOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`cosmosdb_listContainers\`: Lists all containers in the configured database, with their partition key paths. Use this first to explore available data.
+- \`cosmosdb_query\`: Executes a Cosmos DB SQL (Core / NoSQL API) query against a single container and returns items. Use for schema exploration, data sampling, and analytical queries. Pass \`partitionKey\` to scope the query to a single partition (cross-partition queries are enabled by default).
+
+### Business Logic
+
+The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below. Do NOT access credentials directly from environment variables.
+
+\u26A0\uFE0F **The client returned by \`connection(connectionId)\` is NOT the raw \`@azure/cosmos\` \`CosmosClient\`.** It is a thin wrapper exposing only two methods:
+- \`client.query<T>(container, sql, options?) => Promise<T[]>\` \u2014 runs a Cosmos SQL query against the named container and returns the **already-unwrapped** items array (no \`{ resources }\` wrapper). \`options\` accepts \`{ maxItemCount?: number; partitionKey?: unknown }\`.
+- \`client.listContainers() => Promise<{ id: string; partitionKey?: string[] }[]>\` \u2014 lists containers in the configured database.
+
+There is **no** \`client.databases\`, \`client.database(...)\`, \`client.container(...)\`, or \`client.items\`. Do NOT attempt to use the \`@azure/cosmos\` \`CosmosClient\` API directly through this client \u2014 those calls will fail with \`Cannot read properties of undefined\`.
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/cosmosdb";
+
+const cosmos = connection("<connectionId>");
+
+export default async function handler(_c: Context) {
+  // \`query\` returns the items array directly \u2014 no \`.resources\` to unwrap.
+  const rows = await cosmos.query<{ prod: string; orderCount: number }>(
+    "<containerName>",
+    "SELECT c.prod, COUNT(1) AS orderCount FROM c GROUP BY c.prod",
+    // Optional: scope to a single partition to save RUs.
+    // { partitionKey: "<partitionKeyValue>" },
+  );
+
+  rows.sort((a, b) => Number(b.orderCount) - Number(a.orderCount));
+
+  return new Response(JSON.stringify(rows), {
+    headers: { "Content-Type": "application/json" },
+  });
+}
+\`\`\`
+
+### Cosmos DB SQL Reference
+- Cosmos DB stores schema-flexible JSON items in **containers** organised under a **database**. Items are partitioned by a per-container partition key path.
+- Queries always target a single container and reference items via the alias \`c\` (e.g. \`SELECT c.id, c.name FROM c WHERE c.status = 'active'\`).
+- Row limiting: use \`TOP n\` (e.g. \`SELECT TOP 100 * FROM c\`). \`LIMIT\` is **not** supported. \`OFFSET m LIMIT n\` is supported on newer accounts but \`TOP\` is the safe default.
+- System fields are prefixed with an underscore (\`c.id\`, \`c._ts\` for the modification timestamp, \`c._etag\`).
+- Aggregates: \`COUNT(1)\`, \`SUM\`, \`AVG\`, \`MIN\`, \`MAX\`, with \`GROUP BY\` (e.g. \`SELECT c.country, COUNT(1) AS n FROM c GROUP BY c.country\`).
+- Joins: only **intra-document** joins via \`JOIN\` over arrays inside the same item; there is no cross-container/cross-document join.
+- Always bound results with \`TOP n\` and prefer scoped queries with a \`partitionKey\` value when possible \u2014 cross-partition queries cost more RUs.`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`cosmosdb_listContainers\`: \u8A2D\u5B9A\u3055\u308C\u305F\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u5185\u306E\u30B3\u30F3\u30C6\u30CA\u4E00\u89A7\uFF08\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u30AD\u30FC\u306E\u30D1\u30B9\u4ED8\u304D\uFF09\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30C7\u30FC\u30BF\u63A2\u7D22\u306E\u6700\u521D\u306E\u30B9\u30C6\u30C3\u30D7\u3068\u3057\u3066\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \`cosmosdb_query\`: \u5358\u4E00\u306E\u30B3\u30F3\u30C6\u30CA\u306B\u5BFE\u3057\u3066 Cosmos DB SQL\uFF08Core / NoSQL API\uFF09\u30AF\u30A8\u30EA\u3092\u5B9F\u884C\u3057\u3001\u30A2\u30A4\u30C6\u30E0\u3092\u8FD4\u3057\u307E\u3059\u3002\u30B9\u30AD\u30FC\u30DE\u63A2\u7D22\u3001\u30C7\u30FC\u30BF\u306E\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u3001\u5206\u6790\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\`partitionKey\` \u3092\u6E21\u3059\u3068\u5358\u4E00\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u306B\u30B9\u30B3\u30FC\u30D7\u3067\u304D\u3001\u672A\u6307\u5B9A\u3060\u3068\u30AF\u30ED\u30B9\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u30AF\u30A8\u30EA\u306B\u306A\u308A\u307E\u3059\u3002
+
+### Business Logic
+
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+
+\u26A0\uFE0F **\`connection(connectionId)\` \u304C\u8FD4\u3059\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\u306F \`@azure/cosmos\` \u306E \`CosmosClient\` \u305D\u306E\u3082\u306E\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002** \u4EE5\u4E0B\u306E2\u30E1\u30BD\u30C3\u30C9\u306E\u307F\u3092\u516C\u958B\u3059\u308B\u8584\u3044\u30E9\u30C3\u30D1\u30FC\u3067\u3059\uFF1A
+- \`client.query<T>(container, sql, options?) => Promise<T[]>\` \u2014 \u6307\u5B9A\u30B3\u30F3\u30C6\u30CA\u306B\u5BFE\u3057\u3066 Cosmos SQL \u3092\u5B9F\u884C\u3057\u3001**\u3059\u3067\u306B\u5C55\u958B\u6E08\u307F\u306E\u30A2\u30A4\u30C6\u30E0\u914D\u5217**\u3092\u8FD4\u3059\uFF08\`{ resources }\` \u3067\u30E9\u30C3\u30D7\u3055\u308C\u3066\u3044\u306A\u3044\uFF09\u3002\`options\` \u306F \`{ maxItemCount?: number; partitionKey?: unknown }\`\u3002
+- \`client.listContainers() => Promise<{ id: string; partitionKey?: string[] }[]>\` \u2014 \u8A2D\u5B9A\u3055\u308C\u305F\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u5185\u306E\u30B3\u30F3\u30C6\u30CA\u4E00\u89A7\u3092\u8FD4\u3059\u3002
+
+\`client.databases\`\u3001\`client.database(...)\`\u3001\`client.container(...)\`\u3001\`client.items\` \u306F **\u5B58\u5728\u3057\u306A\u3044**\u3002\`@azure/cosmos\` \u306E \`CosmosClient\` API \u3092\u3053\u306E\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\u8D8A\u3057\u306B\u76F4\u63A5\u4F7F\u304A\u3046\u3068\u3057\u306A\u3044\u3053\u3068 \u2014 \`Cannot read properties of undefined\` \u3067\u5931\u6557\u3059\u308B\u3002
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/cosmosdb";
+
+const cosmos = connection("<connectionId>");
+
+export default async function handler(_c: Context) {
+  // \`query\` \u306F items \u914D\u5217\u3092\u305D\u306E\u307E\u307E\u8FD4\u3059 \u2014 \`.resources\` \u306E\u5C55\u958B\u306F\u4E0D\u8981\u3002
+  const rows = await cosmos.query<{ prod: string; orderCount: number }>(
+    "<containerName>",
+    "SELECT c.prod, COUNT(1) AS orderCount FROM c GROUP BY c.prod",
+    // \u4EFB\u610F: \u5358\u4E00\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u306B\u30B9\u30B3\u30FC\u30D7\u3057\u3066 RU \u3092\u7BC0\u7D04\u3002
+    // { partitionKey: "<partitionKeyValue>" },
+  );
+
+  rows.sort((a, b) => Number(b.orderCount) - Number(a.orderCount));
+
+  return new Response(JSON.stringify(rows), {
+    headers: { "Content-Type": "application/json" },
+  });
+}
+\`\`\`
+
+### Cosmos DB SQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+- Cosmos DB \u306F\u30B9\u30AD\u30FC\u30DE\u67D4\u8EDF\u306A JSON \u30A2\u30A4\u30C6\u30E0\u3092 **\u30B3\u30F3\u30C6\u30CA** \u306B\u683C\u7D0D\u3057\u3001\u30B3\u30F3\u30C6\u30CA\u306F\u30B3\u30F3\u30C6\u30CA\u3054\u3068\u306E\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u30AD\u30FC\u30D1\u30B9\u3067\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u5206\u5272\u3055\u308C\u307E\u3059\u3002\u30B3\u30F3\u30C6\u30CA\u306F **\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9** \u306B\u307E\u3068\u3081\u3089\u308C\u307E\u3059\u3002
+- \u30AF\u30A8\u30EA\u306F\u5E38\u306B\u5358\u4E00\u30B3\u30F3\u30C6\u30CA\u3092\u5BFE\u8C61\u3068\u3057\u3001\u30A2\u30A4\u30C6\u30E0\u306F\u5225\u540D \`c\` \u3067\u53C2\u7167\u3057\u307E\u3059\uFF08\u4F8B: \`SELECT c.id, c.name FROM c WHERE c.status = 'active'\`\uFF09\u3002
+- \u884C\u6570\u5236\u9650: \`TOP n\` \u3092\u4F7F\u7528\u3057\u307E\u3059\uFF08\u4F8B: \`SELECT TOP 100 * FROM c\`\uFF09\u3002\`LIMIT\` \u306F **\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093**\u3002\u65B0\u3057\u3044\u30A2\u30AB\u30A6\u30F3\u30C8\u3067\u306F \`OFFSET m LIMIT n\` \u304C\u4F7F\u3048\u307E\u3059\u304C\u3001\u5B89\u5168\u5074\u306E\u65E2\u5B9A\u306F \`TOP\` \u3067\u3059\u3002
+- \u30B7\u30B9\u30C6\u30E0\u30D5\u30A3\u30FC\u30EB\u30C9\u306F\u30A2\u30F3\u30C0\u30FC\u30B9\u30B3\u30A2\u59CB\u307E\u308A\uFF08\`c.id\`\u3001\u5909\u66F4\u6642\u523B\u306E \`c._ts\`\u3001\`c._etag\`\uFF09\u3002
+- \u96C6\u7D04: \`COUNT(1)\`\u3001\`SUM\`\u3001\`AVG\`\u3001\`MIN\`\u3001\`MAX\` \u3092 \`GROUP BY\` \u3068\u7D44\u307F\u5408\u308F\u305B\u307E\u3059\uFF08\u4F8B: \`SELECT c.country, COUNT(1) AS n FROM c GROUP BY c.country\`\uFF09\u3002
+- \u7D50\u5408: \u540C\u4E00\u30A2\u30A4\u30C6\u30E0\u5185\u306E\u914D\u5217\u306B\u5BFE\u3059\u308B **\u30A4\u30F3\u30C8\u30E9\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8** \`JOIN\` \u306E\u307F\u3067\u3001\u30B3\u30F3\u30C6\u30CA\u9593\uFF0F\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u9593\u306E\u7D50\u5408\u306F\u30B5\u30DD\u30FC\u30C8\u3055\u308C\u307E\u305B\u3093\u3002
+- \u7D50\u679C\u4EF6\u6570\u306F\u5FC5\u305A \`TOP n\` \u3067\u5236\u9650\u3057\u3001\u53EF\u80FD\u3067\u3042\u308C\u3070 \`partitionKey\` \u3067\u5358\u4E00\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u306B\u30B9\u30B3\u30FC\u30D7\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\u30AF\u30ED\u30B9\u30D1\u30FC\u30C6\u30A3\u30B7\u30E7\u30F3\u30AF\u30A8\u30EA\u306F RU \u3092\u591A\u304F\u6D88\u8CBB\u3057\u307E\u3059\uFF09\u3002`
+  },
+  tools: tools74,
+  async checkConnection(params, _config) {
+    try {
+      const { CosmosClient } = await import("@azure/cosmos");
+      const client = new CosmosClient({
+        endpoint: params[parameters74.endpoint.slug],
+        key: params[parameters74.key.slug]
+      });
+      const database = params[parameters74.database.slug];
+      await client.database(database).read();
+      return { success: true };
+    } catch (error2) {
+      const msg = error2 instanceof Error ? error2.message : String(error2);
+      const key = params[parameters74.key.slug];
+      return {
+        success: false,
+        error: key ? msg.replaceAll(key, "***") : msg
+      };
+    }
   }
 });
 
@@ -113951,7 +114452,7 @@ var oracleOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/oracle/parameters.ts
-var parameters74 = {
+var parameters75 = {
   jdbcUrl: new ParameterDefinition({
     slug: "jdbc-url",
     name: "Oracle JDBC URL",
@@ -113978,31 +114479,32 @@ var parameters74 = {
     type: "text",
     secret: true,
     required: false
-  })
+  }),
+  ...sshTunnelParameters
 };
 
 // ../connectors/src/connectors/oracle/tools/execute-query.ts
-import { z as z90 } from "zod";
+import { z as z92 } from "zod";
 var MAX_ROWS16 = 500;
-var inputSchema90 = z90.object({
-  toolUseIntent: z90.string().optional().describe(
+var inputSchema92 = z92.object({
+  toolUseIntent: z92.string().optional().describe(
     "Brief description of what you intend to accomplish with this tool call"
   ),
-  connectionId: z90.string().describe("ID of the Oracle connection to use"),
-  sql: z90.string().describe(
+  connectionId: z92.string().describe("ID of the Oracle connection to use"),
+  sql: z92.string().describe(
     "PL/SQL-compatible query. Oracle has no `LIMIT`; use `FETCH FIRST n ROWS ONLY` or filter on `ROWNUM`. Don't end the statement with a semicolon \u2014 the driver rejects trailing terminators."
   )
 });
-var outputSchema90 = z90.discriminatedUnion("success", [
-  z90.object({
-    success: z90.literal(true),
-    rowCount: z90.number(),
-    truncated: z90.boolean(),
-    rows: z90.array(z90.record(z90.string(), z90.unknown()))
+var outputSchema92 = z92.discriminatedUnion("success", [
+  z92.object({
+    success: z92.literal(true),
+    rowCount: z92.number(),
+    truncated: z92.boolean(),
+    rows: z92.array(z92.record(z92.string(), z92.unknown()))
   }),
-  z90.object({
-    success: z90.literal(false),
-    error: z90.string()
+  z92.object({
+    success: z92.literal(false),
+    error: z92.string()
   })
 ]);
 var executeQueryTool16 = new ConnectorTool({
@@ -114012,8 +114514,8 @@ Use for: schema exploration via \`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_T
 Oracle uses \`FETCH FIRST n ROWS ONLY\` (12c+) or \`ROWNUM\` for row limiting \u2014 there is no \`LIMIT\` keyword.
 Unquoted identifiers are stored upper-case (\`SELECT * FROM employees\` resolves to \`EMPLOYEES\`).
 Do NOT terminate statements with a semicolon; the driver rejects trailing terminators.`,
-  inputSchema: inputSchema90,
-  outputSchema: outputSchema90,
+  inputSchema: inputSchema92,
+  outputSchema: outputSchema92,
   async execute({ connectionId, sql }, connections) {
     const connection = connections.find((c6) => c6.id === connectionId);
     if (!connection) {
@@ -114022,9 +114524,9 @@ Do NOT terminate statements with a semicolon; the driver rejects trailing termin
         error: `Connection ${connectionId} not found`
       };
     }
-    const jdbcUrl = parameters74.jdbcUrl.getValue(connection);
-    const username = parameters74.username.tryGetValue(connection);
-    const password = parameters74.password.tryGetValue(connection);
+    const jdbcUrl = parameters75.jdbcUrl.getValue(connection);
+    const username = parameters75.username.tryGetValue(connection);
+    const password = parameters75.password.tryGetValue(connection);
     console.log(
       `[connector-query] oracle/${connection.name} (${redactOracleUrl(jdbcUrl)}): ${sql}`
     );
@@ -114039,7 +114541,9 @@ Do NOT terminate statements with a semicolon; the driver rejects trailing termin
     }
     try {
       const cleanSql = sql.replace(/;\s*$/, "");
-      const { rows } = await runOracleQuery(parsed, cleanSql);
+      const { rows } = await runOracleQuery(parsed, cleanSql, {
+        tunnelParams: connectionParamsToRecord(connection)
+      });
       const truncated = rows.length > MAX_ROWS16;
       return {
         success: true,
@@ -114056,14 +114560,14 @@ Do NOT terminate statements with a semicolon; the driver rejects trailing termin
 });
 
 // ../connectors/src/connectors/oracle/index.ts
-var tools74 = { executeQuery: executeQueryTool16 };
+var tools75 = { executeQuery: executeQueryTool16 };
 var oracleConnector = new ConnectorPlugin({
   slug: "oracle",
   authType: AUTH_TYPES.USER_PASSWORD,
   name: "Oracle Database",
   description: "Connect to Oracle Database using a JDBC-style URL via the pure-JS Thin driver (no Oracle Instant Client required).",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/3iGEdzvGHncU5bYqFOROiV/9e7bdda7230d7ca6b34e7f6a862de876/oracle-icon.webp",
-  parameters: parameters74,
+  parameters: parameters75,
   releaseFlag: { dev1: true, dev2: false, prod: false },
   categories: ["database"],
   onboarding: oracleOnboarding,
@@ -114107,26 +114611,32 @@ The business logic type for this connector is "sql".
 - \u30B9\u30C6\u30FC\u30C8\u30E1\u30F3\u30C8\u672B\u5C3E\u306B\u30BB\u30DF\u30B3\u30ED\u30F3\u3092\u4ED8\u3051\u306A\u3044\u3067\u304F\u3060\u3055\u3044\uFF08thin \u30C9\u30E9\u30A4\u30D0\u304C\u62D2\u5426\u3057\u307E\u3059\uFF09\u3002
 - \u884C\u6570\u5236\u9650\u306E\u4E92\u63DB\u6027: \u30D7\u30E9\u30C3\u30C8\u30D5\u30A9\u30FC\u30E0\u306E server-logic \u30B9\u30AD\u30FC\u30DE\u63A8\u8AD6\u306F\u3001\u30AF\u30A8\u30EA\u3092 \`SELECT * FROM (<inner>) AS _sq LIMIT N\` \u306E\u5F62\u3067\u30E9\u30C3\u30D7\u3057\u3066\u304F\u308B\u3053\u3068\u304C\u3042\u308A\u307E\u3059\u3002Oracle \u306B\u306F \`LIMIT\` \u30AD\u30FC\u30EF\u30FC\u30C9\u304C\u5B58\u5728\u3057\u306A\u3044\u305F\u3081\u3001\u30B3\u30CD\u30AF\u30BF\u306F \`query()\` \u5185\u3067\u3053\u306E\u30E9\u30C3\u30D1\u3092\u691C\u51FA\u3057\u3001\`<inner>\` \u3092\u305D\u306E\u307E\u307E\u5B9F\u884C\u3057\u3066 JS \u5074\u3067\u5148\u982D N \u884C\u306B\u5207\u308A\u8A70\u3081\u307E\u3059\u3002\u5229\u7528\u8005\u5074\u3067\u5BFE\u51E6\u3059\u308B\u5FC5\u8981\u306F\u3042\u308A\u307E\u305B\u3093\u304C\u3001\u81EA\u5206\u3067\u66F8\u304F SQL \u3067\u306F \`LIMIT\` \u3092\u4F7F\u308F\u305A \`FETCH FIRST N ROWS ONLY\` / \`OFFSET m ROWS FETCH NEXT N ROWS ONLY\` / \`ROWNUM\` \u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002`
   },
-  tools: tools74,
+  tools: tools75,
   async checkConnection(params, _config) {
-    return checkOracleConnection(params[parameters74.jdbcUrl.slug], {
-      username: params[parameters74.username.slug],
-      password: params[parameters74.password.slug]
-    });
+    return checkOracleConnection(
+      params[parameters75.jdbcUrl.slug],
+      {
+        username: params[parameters75.username.slug],
+        password: params[parameters75.password.slug]
+      },
+      { tunnelParams: params }
+    );
   },
   async query(params, sql, _namedParams) {
-    const parsed = parseOracleJdbcUrl(params[parameters74.jdbcUrl.slug], {
-      username: params[parameters74.username.slug],
-      password: params[parameters74.password.slug]
+    const parsed = parseOracleJdbcUrl(params[parameters75.jdbcUrl.slug], {
+      username: params[parameters75.username.slug],
+      password: params[parameters75.password.slug]
     });
     const sample = unwrapSampleLimit(sql);
     if (sample) {
       const inner = sample.inner.replace(/;\s*$/, "");
-      const result = await runOracleQuery(parsed, inner);
+      const result = await runOracleQuery(parsed, inner, {
+        tunnelParams: params
+      });
       return { rows: result.rows.slice(0, sample.limit) };
     }
     const cleanSql = sql.replace(/;\s*$/, "");
-    return runOracleQuery(parsed, cleanSql);
+    return runOracleQuery(parsed, cleanSql, { tunnelParams: params });
   }
 });
 
@@ -114147,7 +114657,7 @@ var freshserviceOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/freshservice/parameters.ts
-var parameters75 = {
+var parameters76 = {
   domain: new ParameterDefinition({
     slug: "domain",
     name: "Freshservice Domain",
@@ -114169,7 +114679,7 @@ var parameters75 = {
 };
 
 // ../connectors/src/connectors/freshservice/tools/request.ts
-import { z as z91 } from "zod";
+import { z as z93 } from "zod";
 var BASE_PATH_SEGMENT12 = "/api/v2";
 var REQUEST_TIMEOUT_MS70 = 6e4;
 function buildBaseUrl(domain) {
@@ -114180,33 +114690,33 @@ function buildBaseUrl(domain) {
 function basicAuthHeader(apiKey) {
   return `Basic ${Buffer.from(`${apiKey}:X`).toString("base64")}`;
 }
-var inputSchema91 = z91.object({
-  toolUseIntent: z91.string().optional().describe(
+var inputSchema93 = z93.object({
+  toolUseIntent: z93.string().optional().describe(
     "Brief description of what you intend to accomplish with this tool call"
   ),
-  connectionId: z91.string().describe("ID of the Freshservice connection to use"),
-  method: z91.enum(["GET", "POST", "PUT", "DELETE"]).describe(
+  connectionId: z93.string().describe("ID of the Freshservice connection to use"),
+  method: z93.enum(["GET", "POST", "PUT", "DELETE"]).describe(
     "HTTP method. GET for reading resources, POST for creating, PUT for updating, DELETE for removing."
   ),
-  path: z91.string().describe(
+  path: z93.string().describe(
     "API path (e.g., '/tickets', '/tickets/123', '/agents'). Append query parameters such as '?per_page=100&page=1' for pagination."
   ),
-  body: z91.record(z91.string(), z91.unknown()).optional().describe(
+  body: z93.record(z93.string(), z93.unknown()).optional().describe(
     'Request body (JSON) for POST/PUT requests. Example: { "subject": "...", "description": "...", "email": "...", "priority": 2, "status": 2, "source": 2 }.'
   )
 });
-var outputSchema91 = z91.discriminatedUnion("success", [
-  z91.object({
-    success: z91.literal(true),
-    status: z91.number(),
-    data: z91.union([
-      z91.record(z91.string(), z91.unknown()),
-      z91.array(z91.unknown())
+var outputSchema93 = z93.discriminatedUnion("success", [
+  z93.object({
+    success: z93.literal(true),
+    status: z93.number(),
+    data: z93.union([
+      z93.record(z93.string(), z93.unknown()),
+      z93.array(z93.unknown())
     ])
   }),
-  z91.object({
-    success: z91.literal(false),
-    error: z91.string()
+  z93.object({
+    success: z93.literal(false),
+    error: z93.string()
   })
 ]);
 var requestTool52 = new ConnectorTool({
@@ -114237,8 +114747,8 @@ Field codes:
 - ticket priority: 1 Low, 2 Medium, 3 High, 4 Urgent
 - ticket status: 2 Open, 3 Pending, 4 Resolved, 5 Closed
 - ticket source: 1 Email, 2 Portal, 3 Phone, 4 Chat, 5 Feedback widget, 7 Yammer, 8 AwsCloudwatch, 9 Pagerduty, 10 Walkup, 11 Slack`,
-  inputSchema: inputSchema91,
-  outputSchema: outputSchema91,
+  inputSchema: inputSchema93,
+  outputSchema: outputSchema93,
   async execute({ connectionId, method, path: path5, body }, connections) {
     const connection = connections.find((c6) => c6.id === connectionId);
     if (!connection) {
@@ -114251,8 +114761,8 @@ Field codes:
       `[connector-request] freshservice/${connection.name}: ${method} ${path5}`
     );
     try {
-      const apiKey = parameters75.apiKey.getValue(connection);
-      const domain = parameters75.domain.getValue(connection);
+      const apiKey = parameters76.apiKey.getValue(connection);
+      const domain = parameters76.domain.getValue(connection);
       const baseUrl = buildBaseUrl(domain);
       const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT12);
       const url = `${baseUrl}${normalizedPath}`;
@@ -114291,14 +114801,14 @@ Field codes:
 });
 
 // ../connectors/src/connectors/freshservice/index.ts
-var tools75 = { request: requestTool52 };
+var tools76 = { request: requestTool52 };
 var freshserviceConnector = new ConnectorPlugin({
   slug: "freshservice",
   authType: AUTH_TYPES.API_KEY,
   name: "Freshservice",
   description: "Connect to Freshservice (ITSM) for ticket, agent, asset, and ITIL workflow data via API key.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/6Tj64HZOoIrGgQYDayBosY/3f45b29d3479726b5d245ac38d5a7036/freshservice-icon.svg",
-  parameters: parameters75,
+  parameters: parameters76,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   categories: ["productivity"],
   onboarding: freshserviceOnboarding,
@@ -114456,7 +114966,7 @@ export default async function handler(c: Context) {
 - \`status\`: 2=Open, 3=Pending, 4=Resolved, 5=Closed
 - \`source\`: 1=Email, 2=Portal, 3=Phone, 4=Chat, 5=Feedback widget, 7=Yammer, 8=AwsCloudwatch, 9=Pagerduty, 10=Walkup, 11=Slack`
   },
-  tools: tools75
+  tools: tools76
 });
 
 // ../connectors/src/connectors/freshdesk/setup.ts
@@ -114476,7 +114986,7 @@ var freshdeskOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/freshdesk/parameters.ts
-var parameters76 = {
+var parameters77 = {
   domain: new ParameterDefinition({
     slug: "domain",
     name: "Freshdesk Domain",
@@ -114498,7 +115008,7 @@ var parameters76 = {
 };
 
 // ../connectors/src/connectors/freshdesk/tools/request.ts
-import { z as z92 } from "zod";
+import { z as z94 } from "zod";
 var BASE_PATH_SEGMENT13 = "/api/v2";
 var REQUEST_TIMEOUT_MS71 = 6e4;
 function buildBaseUrl2(domain) {
@@ -114509,33 +115019,33 @@ function buildBaseUrl2(domain) {
 function basicAuthHeader2(apiKey) {
   return `Basic ${Buffer.from(`${apiKey}:X`).toString("base64")}`;
 }
-var inputSchema92 = z92.object({
-  toolUseIntent: z92.string().optional().describe(
+var inputSchema94 = z94.object({
+  toolUseIntent: z94.string().optional().describe(
     "Brief description of what you intend to accomplish with this tool call"
   ),
-  connectionId: z92.string().describe("ID of the Freshdesk connection to use"),
-  method: z92.enum(["GET", "POST", "PUT", "DELETE"]).describe(
+  connectionId: z94.string().describe("ID of the Freshdesk connection to use"),
+  method: z94.enum(["GET", "POST", "PUT", "DELETE"]).describe(
     "HTTP method. GET for reading resources, POST for creating, PUT for updating, DELETE for removing."
   ),
-  path: z92.string().describe(
+  path: z94.string().describe(
     "API path (e.g., '/tickets', '/tickets/123', '/contacts'). Append query parameters such as '?per_page=100&page=1&order_by=created_at&order_type=desc'."
   ),
-  body: z92.record(z92.string(), z92.unknown()).optional().describe(
+  body: z94.record(z94.string(), z94.unknown()).optional().describe(
     'Request body (JSON) for POST/PUT requests. Example creating a ticket: { "subject": "...", "description": "...", "email": "...", "priority": 2, "status": 2, "source": 1 }.'
   )
 });
-var outputSchema92 = z92.discriminatedUnion("success", [
-  z92.object({
-    success: z92.literal(true),
-    status: z92.number(),
-    data: z92.union([
-      z92.record(z92.string(), z92.unknown()),
-      z92.array(z92.unknown())
+var outputSchema94 = z94.discriminatedUnion("success", [
+  z94.object({
+    success: z94.literal(true),
+    status: z94.number(),
+    data: z94.union([
+      z94.record(z94.string(), z94.unknown()),
+      z94.array(z94.unknown())
     ])
   }),
-  z92.object({
-    success: z92.literal(false),
-    error: z92.string()
+  z94.object({
+    success: z94.literal(false),
+    error: z94.string()
   })
 ]);
 var requestTool53 = new ConnectorTool({
@@ -114566,8 +115076,8 @@ Field codes (tickets):
 - priority: 1 Low, 2 Medium, 3 High, 4 Urgent
 - status: 2 Open, 3 Pending, 4 Resolved, 5 Closed
 - source: 1 Email, 2 Portal, 3 Phone, 7 Chat, 9 Feedback widget, 10 Outbound email`,
-  inputSchema: inputSchema92,
-  outputSchema: outputSchema92,
+  inputSchema: inputSchema94,
+  outputSchema: outputSchema94,
   async execute({ connectionId, method, path: path5, body }, connections) {
     const connection = connections.find((c6) => c6.id === connectionId);
     if (!connection) {
@@ -114580,8 +115090,8 @@ Field codes (tickets):
       `[connector-request] freshdesk/${connection.name}: ${method} ${path5}`
     );
     try {
-      const apiKey = parameters76.apiKey.getValue(connection);
-      const domain = parameters76.domain.getValue(connection);
+      const apiKey = parameters77.apiKey.getValue(connection);
+      const domain = parameters77.domain.getValue(connection);
       const baseUrl = buildBaseUrl2(domain);
       const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT13);
       const url = `${baseUrl}${normalizedPath}`;
@@ -114620,14 +115130,14 @@ Field codes (tickets):
 });
 
 // ../connectors/src/connectors/freshdesk/index.ts
-var tools76 = { request: requestTool53 };
+var tools77 = { request: requestTool53 };
 var freshdeskConnector = new ConnectorPlugin({
   slug: "freshdesk",
   authType: AUTH_TYPES.API_KEY,
   name: "Freshdesk",
   description: "Connect to Freshdesk for customer support ticket, contact, and company data via API key.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/1PSjIfQJgTYmiWriNTx4uE/26905f4120713bda0afd0b23d02a154e/freshdesk-icon.png",
-  parameters: parameters76,
+  parameters: parameters77,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   categories: ["crm"],
   onboarding: freshdeskOnboarding,
@@ -114787,7 +115297,7 @@ export default async function handler(c: Context) {
 - \`status\`: 2=Open, 3=Pending, 4=Resolved, 5=Closed
 - \`source\`: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback widget, 10=Outbound email`
   },
-  tools: tools76
+  tools: tools77
 });
 
 // ../connectors/src/connectors/freshsales/setup.ts
@@ -114807,7 +115317,7 @@ var freshsalesOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/freshsales/parameters.ts
-var parameters77 = {
+var parameters78 = {
   bundleAlias: new ParameterDefinition({
     slug: "bundle-alias",
     name: "Freshsales Bundle Alias",
@@ -114829,7 +115339,7 @@ var parameters77 = {
 };
 
 // ../connectors/src/connectors/freshsales/tools/request.ts
-import { z as z93 } from "zod";
+import { z as z95 } from "zod";
 var BASE_PATH_SEGMENT14 = "/crm/sales/api";
 var REQUEST_TIMEOUT_MS72 = 6e4;
 function buildBaseUrl3(bundleAlias) {
@@ -114837,33 +115347,33 @@ function buildBaseUrl3(bundleAlias) {
   const subdomain = trimmed.split(".")[0];
   return `https://${subdomain}.myfreshworks.com${BASE_PATH_SEGMENT14}`;
 }
-var inputSchema93 = z93.object({
-  toolUseIntent: z93.string().optional().describe(
+var inputSchema95 = z95.object({
+  toolUseIntent: z95.string().optional().describe(
     "Brief description of what you intend to accomplish with this tool call"
   ),
-  connectionId: z93.string().describe("ID of the Freshsales connection to use"),
-  method: z93.enum(["GET", "POST", "PUT", "DELETE"]).describe(
+  connectionId: z95.string().describe("ID of the Freshsales connection to use"),
+  method: z95.enum(["GET", "POST", "PUT", "DELETE"]).describe(
     "HTTP method. GET for reading resources (including /lookup), POST for creating, PUT for updating, DELETE for removing."
   ),
-  path: z93.string().describe(
+  path: z95.string().describe(
     "API path (e.g., '/contacts', '/contacts/filters', '/contacts/view/{view_id}', '/deals/{id}', '/lookup'). Append query parameters such as '?page=1&per_page=100'."
   ),
-  body: z93.record(z93.string(), z93.unknown()).optional().describe(
+  body: z95.record(z95.string(), z95.unknown()).optional().describe(
     'Request body (JSON). For creating a contact: { "contact": { "first_name": "...", "last_name": "...", "email": "..." } }. For lookup: { "q": "john@example.com", "f": "email", "entities": "contact" }.'
   )
 });
-var outputSchema93 = z93.discriminatedUnion("success", [
-  z93.object({
-    success: z93.literal(true),
-    status: z93.number(),
-    data: z93.union([
-      z93.record(z93.string(), z93.unknown()),
-      z93.array(z93.unknown())
+var outputSchema95 = z95.discriminatedUnion("success", [
+  z95.object({
+    success: z95.literal(true),
+    status: z95.number(),
+    data: z95.union([
+      z95.record(z95.string(), z95.unknown()),
+      z95.array(z95.unknown())
     ])
   }),
-  z93.object({
-    success: z93.literal(false),
-    error: z93.string()
+  z95.object({
+    success: z95.literal(false),
+    error: z95.string()
   })
 ]);
 var requestTool54 = new ConnectorTool({
@@ -114896,8 +115406,8 @@ Common endpoints:
 Pagination: 1-indexed \`page\` + \`per_page\` (default 25, max 100). View endpoints return \`{ contacts/sales_accounts/deals: [...], meta: { total_pages, total } }\`.
 
 Includes: most GET endpoints accept \`?include=\` with a comma-separated list (\`owner\`, \`creator\`, \`deals\`, \`contacts\`, etc.) to inline related records.`,
-  inputSchema: inputSchema93,
-  outputSchema: outputSchema93,
+  inputSchema: inputSchema95,
+  outputSchema: outputSchema95,
   async execute({ connectionId, method, path: path5, body }, connections) {
     const connection = connections.find((c6) => c6.id === connectionId);
     if (!connection) {
@@ -114910,8 +115420,8 @@ Includes: most GET endpoints accept \`?include=\` with a comma-separated list (\
       `[connector-request] freshsales/${connection.name}: ${method} ${path5}`
     );
     try {
-      const apiKey = parameters77.apiKey.getValue(connection);
-      const bundle = parameters77.bundleAlias.getValue(connection);
+      const apiKey = parameters78.apiKey.getValue(connection);
+      const bundle = parameters78.bundleAlias.getValue(connection);
       const baseUrl = buildBaseUrl3(bundle);
       const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT14);
       const url = `${baseUrl}${normalizedPath}`;
@@ -114949,14 +115459,14 @@ Includes: most GET endpoints accept \`?include=\` with a comma-separated list (\
 });
 
 // ../connectors/src/connectors/freshsales/index.ts
-var tools77 = { request: requestTool54 };
+var tools78 = { request: requestTool54 };
 var freshsalesConnector = new ConnectorPlugin({
   slug: "freshsales",
   authType: AUTH_TYPES.API_KEY,
   name: "Freshsales",
   description: "Connect to Freshsales / Freshworks CRM for contact, account, and deal data via API key.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/4UDOrFPM6wOFekbMVljjgl/4acc6060c3a1ff703980e6f4e76a3cd4/629b6c6f7c5cd817694c321f.png",
-  parameters: parameters77,
+  parameters: parameters78,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   categories: ["crm"],
   onboarding: freshsalesOnboarding,
@@ -115128,7 +115638,7 @@ export default async function handler(c: Context) {
 - GET \`/selector/lifecycle_stages\` \u2014 \u30E9\u30A4\u30D5\u30B5\u30A4\u30AF\u30EB\u30B9\u30C6\u30FC\u30B8
 - GET \`/selector/territories\` / \`/selector/business_types\` / \`/selector/industry_types\` / \`/selector/contact_statuses\` / \`/selector/sales_activity_types\``
   },
-  tools: tools77
+  tools: tools78
 });
 
 // ../connectors/src/connectors/github/setup.ts
@@ -115154,7 +115664,7 @@ var githubOnboarding = new ConnectorOnboarding({
 });
 
 // ../connectors/src/connectors/github/parameters.ts
-var parameters78 = {
+var parameters79 = {
   personalAccessToken: new ParameterDefinition({
     slug: "personal-access-token",
     name: "GitHub Personal Access Token",
@@ -115177,42 +115687,42 @@ var parameters78 = {
 var DEFAULT_BASE_URL = "https://api.github.com";
 
 // ../connectors/src/connectors/github/tools/request.ts
-import { z as z94 } from "zod";
+import { z as z96 } from "zod";
 var REQUEST_TIMEOUT_MS73 = 6e4;
 function resolveBaseUrl(connectionBaseUrl) {
   const trimmed = connectionBaseUrl?.trim();
   return trimmed && trimmed.replace(/\/+$/, "") || DEFAULT_BASE_URL;
 }
-var inputSchema94 = z94.object({
-  toolUseIntent: z94.string().optional().describe(
+var inputSchema96 = z96.object({
+  toolUseIntent: z96.string().optional().describe(
     "Brief description of what you intend to accomplish with this tool call"
   ),
-  connectionId: z94.string().describe("ID of the GitHub connection to use"),
-  method: z94.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).describe(
+  connectionId: z96.string().describe("ID of the GitHub connection to use"),
+  method: z96.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).describe(
     "HTTP method. GET for reading, POST for creating, PATCH for partial updates, PUT for replacement (e.g. starring), DELETE for removal."
   ),
-  path: z94.string().describe(
+  path: z96.string().describe(
     "API path (e.g., '/user', '/repos/{owner}/{repo}/issues', '/search/repositories?q=topic:react'). Append query parameters such as '?state=open&per_page=100&page=1'."
   ),
-  body: z94.union([
-    z94.record(z94.string(), z94.unknown()),
-    z94.array(z94.unknown())
+  body: z96.union([
+    z96.record(z96.string(), z96.unknown()),
+    z96.array(z96.unknown())
   ]).optional().describe(
     'Request body (JSON). Example creating an issue: { "title": "...", "body": "...", "labels": ["bug"] }.'
   )
 });
-var outputSchema94 = z94.discriminatedUnion("success", [
-  z94.object({
-    success: z94.literal(true),
-    status: z94.number(),
-    data: z94.union([
-      z94.record(z94.string(), z94.unknown()),
-      z94.array(z94.unknown())
+var outputSchema96 = z96.discriminatedUnion("success", [
+  z96.object({
+    success: z96.literal(true),
+    status: z96.number(),
+    data: z96.union([
+      z96.record(z96.string(), z96.unknown()),
+      z96.array(z96.unknown())
     ])
   }),
-  z94.object({
-    success: z94.literal(false),
-    error: z94.string()
+  z96.object({
+    success: z96.literal(false),
+    error: z96.string()
   })
 ]);
 var requestTool55 = new ConnectorTool({
@@ -115250,8 +115760,8 @@ Common endpoints:
 Pagination: 1-indexed \`page\` + \`per_page\` (max 100). The \`Link\` response header exposes \`rel="next"\`/\`rel="last"\` URLs.
 
 Rate limits: 5,000 req/hr on REST endpoints, 30 req/min on /search/*. Inspect \`X-RateLimit-Remaining\` to throttle.`,
-  inputSchema: inputSchema94,
-  outputSchema: outputSchema94,
+  inputSchema: inputSchema96,
+  outputSchema: outputSchema96,
   async execute({ connectionId, method, path: path5, body }, connections) {
     const connection = connections.find((c6) => c6.id === connectionId);
     if (!connection) {
@@ -115264,8 +115774,8 @@ Rate limits: 5,000 req/hr on REST endpoints, 30 req/min on /search/*. Inspect \`
       `[connector-request] github/${connection.name}: ${method} ${path5}`
     );
     try {
-      const token = parameters78.personalAccessToken.getValue(connection);
-      const baseUrl = resolveBaseUrl(parameters78.baseUrl.tryGetValue(connection));
+      const token = parameters79.personalAccessToken.getValue(connection);
+      const baseUrl = resolveBaseUrl(parameters79.baseUrl.tryGetValue(connection));
       const trimmedPath = path5.trim().replace(/^\/+/, "/");
       const url = `${baseUrl}${trimmedPath.startsWith("/") ? "" : "/"}${trimmedPath}`;
       const controller = new AbortController();
@@ -115305,14 +115815,14 @@ Rate limits: 5,000 req/hr on REST endpoints, 30 req/min on /search/*. Inspect \`
 });
 
 // ../connectors/src/connectors/github/index.ts
-var tools78 = { request: requestTool55 };
+var tools79 = { request: requestTool55 };
 var githubConnector = new ConnectorPlugin({
   slug: "github",
   authType: AUTH_TYPES.PAT,
   name: "GitHub",
   description: "Connect to GitHub for repository, issue, pull request, commit, and search data via Personal Access Token (Classic or fine-grained).",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/2flOAufkhDrLKuOQqEVS3/1f9dcf145680ef77aef149709263e2d4/github-icon.svg",
-  parameters: parameters78,
+  parameters: parameters79,
   releaseFlag: { dev1: true, dev2: true, prod: true },
   categories: ["productivity"],
   onboarding: githubOnboarding,
@@ -115532,7 +116042,7 @@ export default async function handler(c: Context) {
 **\u30AF\u30A9\u30FC\u30BF**
 - GET \`/rate_limit\` \u2014 REST / GraphQL / search \u306E\u6B8B\u30EC\u30FC\u30C8\u78BA\u8A8D`
   },
-  tools: tools78
+  tools: tools79
 });
 
 // ../connectors/src/connectors/registry.ts
@@ -115610,6 +116120,7 @@ var plugins = {
   clickup: clickupConnector,
   sqlserver: sqlserverConnector,
   azureSql: azureSqlConnector,
+  cosmosdb: cosmosdbConnector,
   oracle: oracleConnector,
   freshservice: freshserviceConnector,
   freshdesk: freshdeskConnector,
@@ -115841,62 +116352,62 @@ import { watch as fsWatch2 } from "fs";
 import path2 from "path";
 
 // src/types/server-logic.ts
-import { z as z95 } from "zod";
-var parameterMetaSchema = z95.object({
-  name: z95.string(),
-  type: z95.enum(["string", "number", "boolean"]),
-  description: z95.string(),
-  required: z95.boolean().optional(),
-  default: z95.union([z95.string(), z95.number(), z95.boolean()]).optional()
-});
-var serverLogicCacheConfigSchema = z95.object({
-  ttl: z95.number(),
-  staleWhileRevalidate: z95.boolean().optional()
-});
-var serverLogicSchemaObjectSchema = z95.lazy(
-  () => z95.object({
-    type: z95.enum(["string", "number", "integer", "boolean", "object", "array", "null"]).optional(),
-    format: z95.string().optional(),
-    description: z95.string().optional(),
-    nullable: z95.boolean().optional(),
-    enum: z95.array(z95.union([z95.string(), z95.number(), z95.boolean(), z95.null()])).optional(),
+import { z as z97 } from "zod";
+var parameterMetaSchema = z97.object({
+  name: z97.string(),
+  type: z97.enum(["string", "number", "boolean"]),
+  description: z97.string(),
+  required: z97.boolean().optional(),
+  default: z97.union([z97.string(), z97.number(), z97.boolean()]).optional()
+});
+var serverLogicCacheConfigSchema = z97.object({
+  ttl: z97.number(),
+  staleWhileRevalidate: z97.boolean().optional()
+});
+var serverLogicSchemaObjectSchema = z97.lazy(
+  () => z97.object({
+    type: z97.enum(["string", "number", "integer", "boolean", "object", "array", "null"]).optional(),
+    format: z97.string().optional(),
+    description: z97.string().optional(),
+    nullable: z97.boolean().optional(),
+    enum: z97.array(z97.union([z97.string(), z97.number(), z97.boolean(), z97.null()])).optional(),
     items: serverLogicSchemaObjectSchema.optional(),
-    properties: z95.record(z95.string(), serverLogicSchemaObjectSchema).optional(),
-    required: z95.array(z95.string()).optional(),
-    additionalProperties: z95.union([z95.boolean(), serverLogicSchemaObjectSchema]).optional(),
-    minimum: z95.number().optional(),
-    maximum: z95.number().optional(),
-    minLength: z95.number().optional(),
-    maxLength: z95.number().optional(),
-    pattern: z95.string().optional()
+    properties: z97.record(z97.string(), serverLogicSchemaObjectSchema).optional(),
+    required: z97.array(z97.string()).optional(),
+    additionalProperties: z97.union([z97.boolean(), serverLogicSchemaObjectSchema]).optional(),
+    minimum: z97.number().optional(),
+    maximum: z97.number().optional(),
+    minLength: z97.number().optional(),
+    maxLength: z97.number().optional(),
+    pattern: z97.string().optional()
   })
 );
-var serverLogicMediaTypeSchema = z95.object({
+var serverLogicMediaTypeSchema = z97.object({
   schema: serverLogicSchemaObjectSchema.optional(),
-  example: z95.unknown().optional()
+  example: z97.unknown().optional()
 });
-var serverLogicResponseSchema = z95.object({
-  description: z95.string().optional(),
-  content: z95.record(z95.string(), serverLogicMediaTypeSchema).optional()
+var serverLogicResponseSchema = z97.object({
+  description: z97.string().optional(),
+  content: z97.record(z97.string(), serverLogicMediaTypeSchema).optional()
 });
 var jsonBaseFields = {
-  description: z95.string(),
-  parameters: z95.array(parameterMetaSchema).optional(),
+  description: z97.string(),
+  parameters: z97.array(parameterMetaSchema).optional(),
   response: serverLogicResponseSchema.optional(),
   cache: serverLogicCacheConfigSchema.optional()
 };
-var jsonSqlServerLogicSchema = z95.object({
+var jsonSqlServerLogicSchema = z97.object({
   ...jsonBaseFields,
-  type: z95.literal("sql").optional(),
-  query: z95.string(),
-  connectionId: z95.string()
+  type: z97.literal("sql").optional(),
+  query: z97.string(),
+  connectionId: z97.string()
 });
-var jsonTypeScriptServerLogicSchema = z95.object({
+var jsonTypeScriptServerLogicSchema = z97.object({
   ...jsonBaseFields,
-  type: z95.literal("typescript"),
-  handlerPath: z95.string()
+  type: z97.literal("typescript"),
+  handlerPath: z97.string()
 });
-var anyJsonServerLogicSchema = z95.union([
+var anyJsonServerLogicSchema = z97.union([
   jsonTypeScriptServerLogicSchema,
   jsonSqlServerLogicSchema
 ]);