@squadbase/vite-server 0.1.17-dev.a9ddcfa → 0.1.17-dev.e4768d1

package/dist/connectors/azure-sql.js

@@ -1,7 +1,12 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -308,7 +313,7 @@ async function runMssqlQuery(parsed, sql, options = {}) {
     try {
       const result = await pool.request().query(sql);
       const recordset = result.recordset ?? [];
-      return { rows: recordset };
+      return { rows: recordset, rowsAffected: result.rowsAffected ?? [] };
     } finally {
       await pool.close();
     }
@@ -474,6 +479,15 @@ var ConnectorPlugin = class _ConnectorPlugin {
    * `runSetupFlow` from `setup-flow.ts`.
    */
   setup;
+  /**
+   * 統一 introspection。SQL DB の `information_schema` / `SHOW` / `DESCRIBE` や SaaS の
+   * メタデータ API といった取得経路の差を吸収し、tables / columns / PK / FK を共通型
+   * {@link IntrospectedSchema} へ正規化して返す。取得経路は {@link IntrospectContext} で
+   * 抽象化され、SQL DB は `ctx.query`、SaaS は `ctx.proxyFetch` + `ctx.params` を使う。
+   * `ctx.profile === true` のときは L2 プロファイル（行数・NULL 率等）も best-effort で埋める。
+   * coding-agent の `DataContextIndex` がデータ地図を構築する際に使う。
+   */
+  introspect;
   /**
    * Opt-out of the default "verify before save" behavior on connection
    * creation. The backend invokes `checkConnection` synchronously while
@@ -488,6 +502,14 @@ var ConnectorPlugin = class _ConnectorPlugin {
    * the default verify-on-create behavior without opt-in.
    */
   skipConnectionCheckOnCreate;
+  /**
+   * 決定論的な「立ち上げ survey」レシピ（ルールベース prewarm 基盤）。実装した connector は、LLM を使わずに
+   * read-only で自分を survey する probe 列（テーブル/列メタデータ → 小サンプル）を宣言する。coding-agent の
+   * recon driver がこれを読み、connector ツールの `execute` を直接呼んで結果を seed にする。未実装の connector は
+   * driver 側で safely skip される（その connection は listConnections のみ seed）。標準 `information_schema` を
+   * 持つ SQL connector は `makeStandardSqlSurveyProbes` を使える。**probe は必ず read-only**。
+   */
+  surveyProbes;
   constructor(config) {
     this.slug = config.slug;
     this.authType = config.authType;
@@ -505,7 +527,9 @@ var ConnectorPlugin = class _ConnectorPlugin {
     this.query = config.query;
     this.checkConnection = config.checkConnection;
     this.setup = config.setup;
+    this.introspect = config.introspect;
     this.skipConnectionCheckOnCreate = config.skipConnectionCheckOnCreate;
+    this.surveyProbes = config.surveyProbes;
   }
   get connectorKey() {
     return _ConnectorPlugin.deriveKey(this.slug, this.authType);
@@ -513,7 +537,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
   /**
    * Create tools for connections that belong to this connector.
    * Filters connections by connectorKey internally.
-   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   * Returns tools keyed as `connector_${connectorKey}_${toolName}`.
    */
   createTools(connections, config, opts) {
     const myConnections = connections.filter(
@@ -523,7 +547,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     for (const t of Object.values(this.tools)) {
       const tool = t.createTool(myConnections, config);
       const originalToModelOutput = tool.toModelOutput;
-      result[`${this.connectorKey}_${t.name}`] = {
+      result[`connector_${this.connectorKey}_${t.name}`] = {
         ...tool,
         toModelOutput: async (options) => {
           if (!originalToModelOutput) {
@@ -543,25 +567,25 @@ var ConnectorPlugin = class _ConnectorPlugin {
     if (authType) return `${slug}-${authType}`;
     const LEGACY_NULL_AUTH_TYPE_MAP = {
       // user-password
-      "postgresql": "user-password",
-      "mysql": "user-password",
-      "clickhouse": "user-password",
-      "kintone": "user-password",
+      postgresql: "user-password",
+      mysql: "user-password",
+      clickhouse: "user-password",
+      kintone: "user-password",
       "squadbase-db": "user-password",
       // service-account
-      "snowflake": "service-account",
-      "bigquery": "service-account",
+      snowflake: "service-account",
+      bigquery: "service-account",
       "google-analytics": "service-account",
       "google-calendar": "service-account",
       "aws-athena": "service-account",
-      "redshift": "service-account",
+      redshift: "service-account",
       // api-key
-      "databricks": "api-key",
-      "dbt": "api-key",
-      "airtable": "api-key",
-      "openai": "api-key",
-      "gemini": "api-key",
-      "anthropic": "api-key",
+      databricks: "api-key",
+      dbt: "api-key",
+      airtable: "api-key",
+      openai: "api-key",
+      gemini: "api-key",
+      anthropic: "api-key",
       "wix-store": "api-key"
     };
     const fallbackAuthType = LEGACY_NULL_AUTH_TYPE_MAP[slug];
@@ -570,6 +594,84 @@ var ConnectorPlugin = class _ConnectorPlugin {
   }
 };
 
+// ../connectors/src/survey-probe.ts
+function rowsOf(output) {
+  if (!output || typeof output !== "object") return [];
+  const o = output;
+  if (o.success === false) return [];
+  return Array.isArray(o.rows) ? o.rows : [];
+}
+function pickString(row, candidates) {
+  for (const key of candidates) {
+    const v = row[key] ?? row[key.toUpperCase()] ?? row[key.toLowerCase()];
+    if (typeof v === "string" && v.length > 0) return v;
+  }
+  return void 0;
+}
+var TABLE_NAME_FIELDS = [
+  "table_name",
+  "name",
+  "tableName",
+  "tab_name",
+  "Table",
+  "table"
+];
+function makeQuoteIdent(opts) {
+  if (opts.bracket) {
+    return (name) => `[${name.replaceAll("]", "]]")}]`;
+  }
+  const q = opts.quote ?? '"';
+  return (name) => `${q}${name.replaceAll(q, q + q)}${q}`;
+}
+function sampleSql(ref, limit) {
+  return `SELECT * FROM (SELECT * FROM ${ref}) AS _sq LIMIT ${limit}`;
+}
+function distinctTables(prior, max) {
+  const names = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const row of rowsOf(prior[0]?.output)) {
+    const name = pickString(row, TABLE_NAME_FIELDS);
+    if (!name || seen.has(name)) continue;
+    seen.add(name);
+    names.push(name);
+    if (names.length >= max) break;
+  }
+  return names;
+}
+function makeStandardSqlSurveyProbes(opts) {
+  const queryTool = opts.queryTool ?? "executeQuery";
+  const sampleLimit = opts.sampleLimit ?? 5;
+  const maxSampleTables = opts.maxSampleTables ?? 4;
+  const quoteIdent = makeQuoteIdent(opts);
+  const whereSchema = opts.schemaLiteral ? ` WHERE table_schema = '${opts.schemaLiteral.replaceAll("'", "''")}'` : opts.schemaExpr ? ` WHERE table_schema = ${opts.schemaExpr}` : "";
+  return (_connectionId, prior) => {
+    if (prior.length === 0) {
+      return [
+        {
+          tool: queryTool,
+          input: {
+            toolUseIntent: "Survey table/column metadata",
+            sql: `SELECT table_name, column_name, data_type FROM information_schema.columns${whereSchema} ORDER BY table_name, ordinal_position LIMIT 1000`
+          }
+        }
+      ];
+    }
+    if (prior.length === 1) {
+      return distinctTables(prior, maxSampleTables).map((name) => {
+        const ref = opts.schemaLiteral ? `${quoteIdent(opts.schemaLiteral)}.${quoteIdent(name)}` : quoteIdent(name);
+        return {
+          tool: queryTool,
+          input: {
+            toolUseIntent: `Sample ${name}`,
+            sql: sampleSql(ref, sampleLimit)
+          }
+        };
+      });
+    }
+    return [];
+  };
+}
+
 // ../connectors/src/setup-flow.ts
 async function runSetupFlow(flow, params, ctx, config) {
   const runtime = {
@@ -640,6 +742,55 @@ async function resolveSetupSelection(params) {
   return resolved.slice(0, limit);
 }
 
+// ../connectors/src/introspect-concurrency.ts
+async function mapWithConcurrency(items, limit, fn) {
+  const results = new Array(items.length);
+  let next = 0;
+  const workers = Array.from(
+    { length: Math.min(Math.max(limit, 1), items.length) },
+    async () => {
+      for (; ; ) {
+        const i = next++;
+        if (i >= items.length) return;
+        results[i] = await fn(items[i]);
+      }
+    }
+  );
+  await Promise.all(workers);
+  return results;
+}
+
+// ../connectors/src/introspect-profile.ts
+var DEFAULT_MAX_TABLES = 200;
+var DEFAULT_CONCURRENCY = 5;
+var quoteBracket = (schema, name) => `[${schema.replace(/\]/g, "]]")}].[${name.replace(/\]/g, "]]")}]`;
+async function withRowCounts(ctx, schemaPromise, quoteRef, opts = {}) {
+  const schema = await schemaPromise;
+  if (!ctx.profile || !ctx.query) return schema;
+  return attachRowCounts(ctx.query, schema, quoteRef, opts);
+}
+async function attachRowCounts(run, schema, quoteRef, opts = {}) {
+  const targets = schema.tables.slice(0, opts.maxTables ?? DEFAULT_MAX_TABLES);
+  await mapWithConcurrency(
+    targets,
+    opts.concurrency ?? DEFAULT_CONCURRENCY,
+    async (table) => {
+      try {
+        const { rows } = await run(
+          `SELECT COUNT(*) AS row_count FROM ${quoteRef(table.schema, table.name)}`
+        );
+        const first = rows[0] ? Object.values(rows[0])[0] : void 0;
+        const rowCount = Number(first);
+        if (Number.isFinite(rowCount)) {
+          table.profile = { ...table.profile ?? {}, rowCount };
+        }
+      } catch {
+      }
+    }
+  );
+  return schema;
+}
+
 // ../connectors/src/auth-types.ts
 var AUTH_TYPES = {
   OAUTH: "oauth",
@@ -650,6 +801,69 @@ var AUTH_TYPES = {
   USER_PASSWORD: "user-password"
 };
 
+// ../connectors/src/introspect-information-schema.ts
+function pickCI(row, key) {
+  if (key in row) return String(row[key] ?? "");
+  const lower = key.toLowerCase();
+  for (const k of Object.keys(row)) {
+    if (k.toLowerCase() === lower) return String(row[k] ?? "");
+  }
+  return "";
+}
+function assembleIntrospectedSchema(input) {
+  const { colRows, pkRows = [], fkRows = [] } = input;
+  const pkSet = /* @__PURE__ */ new Set();
+  for (const r of pkRows) {
+    pkSet.add(
+      `${pickCI(r, "table_schema")}.${pickCI(r, "table_name")}.${pickCI(r, "column_name")}`
+    );
+  }
+  const fkMap = /* @__PURE__ */ new Map();
+  for (const r of fkRows) {
+    fkMap.set(
+      `${pickCI(r, "table_schema")}.${pickCI(r, "table_name")}.${pickCI(r, "column_name")}`,
+      {
+        schema: pickCI(r, "foreign_table_schema"),
+        table: pickCI(r, "foreign_table_name"),
+        column: pickCI(r, "foreign_column_name")
+      }
+    );
+  }
+  const tableMap = /* @__PURE__ */ new Map();
+  for (const r of colRows) {
+    const schema = pickCI(r, "table_schema");
+    const name = pickCI(r, "table_name");
+    const key = `${schema}.${name}`;
+    let table = tableMap.get(key);
+    if (!table) {
+      table = {
+        schema,
+        name,
+        type: pickCI(r, "table_type").toUpperCase() === "VIEW" ? "view" : "table",
+        columns: []
+      };
+      tableMap.set(key, table);
+    }
+    const colKey = `${schema}.${name}.${pickCI(r, "column_name")}`;
+    const column = {
+      name: pickCI(r, "column_name"),
+      dataType: pickCI(r, "data_type"),
+      nullable: pickCI(r, "is_nullable").toUpperCase() === "YES"
+    };
+    if (pkSet.has(colKey)) column.isPrimaryKey = true;
+    const fk = fkMap.get(colKey);
+    if (fk) column.foreignKey = fk;
+    table.columns.push(column);
+  }
+  return { tables: [...tableMap.values()] };
+}
+
+// ../connectors/src/lib/sql-dml.ts
+function isDmlStatement(sql) {
+  const stripped = sql.replace(/^(\s*(--[^\n]*\n|\/\*[\s\S]*?\*\/))+/, "").trimStart();
+  return /^(insert|update|delete|merge)\b/i.test(stripped);
+}
+
 // ../connectors/src/lib/unwrap-sample-limit.ts
 var STRICT_WRAPPER_RE = /^\s*SELECT\s+\*\s+FROM\s+\(([\s\S]+)\)\s+AS\s+\w+\s+LIMIT\s+(\d+)\s*;?\s*$/i;
 var TRAILING_LIMIT_RE = /\s+LIMIT\s+(\d+)\s*;?\s*$/i;
@@ -756,6 +970,28 @@ function buildFlow(options) {
         fetchAll: () => fetchTableNames(rt.params, schema),
         limit: SQLSERVER_SETUP_MAX_TABLES
       });
+      let rowCounts = /* @__PURE__ */ new Map();
+      try {
+        const countRows = await runSqlServerSetupQuery(
+          rt.params,
+          `SELECT t.TABLE_NAME, SUM(p.rows) AS row_count
+           FROM INFORMATION_SCHEMA.TABLES t
+           JOIN sys.partitions p
+             ON OBJECT_ID(t.TABLE_SCHEMA + '.' + t.TABLE_NAME) = p.object_id
+             AND p.index_id IN (0, 1)
+           WHERE t.TABLE_SCHEMA = ${quoteLiteral(schema)}
+             AND t.TABLE_TYPE IN ('BASE TABLE', 'VIEW')
+           GROUP BY t.TABLE_NAME`,
+          forceEncrypt
+        );
+        rowCounts = new Map(
+          countRows.map((r) => [
+            String(r["TABLE_NAME"] ?? ""),
+            Number(r["row_count"] ?? 0)
+          ])
+        );
+      } catch {
+      }
       const sections = [
         `## ${connectorName}`,
         "",
@@ -772,7 +1008,9 @@ function buildFlow(options) {
            ORDER BY ORDINAL_POSITION`,
           forceEncrypt
         );
-        sections.push(`#### Table: ${table}`, "");
+        const rowCount = rowCounts.get(table);
+        const heading = typeof rowCount === "number" ? `#### Table: ${table} (~${rowCount.toLocaleString()} rows)` : `#### Table: ${table}`;
+        sections.push(heading, "");
         sections.push("| Column | Type | Nullable | Default |");
         sections.push("|--------|------|----------|---------|");
         for (const c of cols) {
@@ -798,6 +1036,52 @@ var sqlserverSetupFlow = createSqlServerSetupFlow({
   forceEncrypt: false
 });
 
+// ../connectors/src/connectors/sqlserver/introspect.ts
+async function introspectMssql(run) {
+  const [{ rows: colRows }, { rows: pkRows }, { rows: fkRows }] = await Promise.all([
+    // 1) 全カラム（型 / nullable）+ テーブル種別（BASE TABLE / VIEW）
+    run(
+      `SELECT c.TABLE_SCHEMA AS table_schema, c.TABLE_NAME AS table_name,
+                c.COLUMN_NAME AS column_name, c.DATA_TYPE AS data_type,
+                c.IS_NULLABLE AS is_nullable, c.ORDINAL_POSITION AS ordinal_position,
+                t.TABLE_TYPE AS table_type
+           FROM INFORMATION_SCHEMA.COLUMNS c
+           JOIN INFORMATION_SCHEMA.TABLES t
+             ON t.TABLE_SCHEMA = c.TABLE_SCHEMA AND t.TABLE_NAME = c.TABLE_NAME
+          WHERE c.TABLE_SCHEMA NOT IN ('sys', 'INFORMATION_SCHEMA')
+          ORDER BY c.TABLE_SCHEMA, c.TABLE_NAME, c.ORDINAL_POSITION`
+    ),
+    // 2) 主キー
+    run(
+      `SELECT tc.TABLE_SCHEMA AS table_schema, tc.TABLE_NAME AS table_name,
+                kcu.COLUMN_NAME AS column_name
+           FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS tc
+           JOIN INFORMATION_SCHEMA.KEY_COLUMN_USAGE kcu
+             ON kcu.CONSTRAINT_NAME = tc.CONSTRAINT_NAME
+            AND kcu.TABLE_SCHEMA = tc.TABLE_SCHEMA
+            AND kcu.TABLE_NAME = tc.TABLE_NAME
+          WHERE tc.CONSTRAINT_TYPE = 'PRIMARY KEY'
+            AND tc.TABLE_SCHEMA NOT IN ('sys', 'INFORMATION_SCHEMA')`
+    ),
+    // 3) 外部キー（参照元列 → 参照先列）。sys カタログで複合 FK も 1:1 に解決する。
+    run(
+      `SELECT sch.name AS table_schema, tab.name AS table_name, col.name AS column_name,
+                rsch.name AS foreign_table_schema, rtab.name AS foreign_table_name,
+                rcol.name AS foreign_column_name
+           FROM sys.foreign_key_columns fkc
+           JOIN sys.tables  tab  ON tab.object_id = fkc.parent_object_id
+           JOIN sys.schemas sch  ON sch.schema_id = tab.schema_id
+           JOIN sys.columns col  ON col.object_id = fkc.parent_object_id
+                                AND col.column_id = fkc.parent_column_id
+           JOIN sys.tables  rtab ON rtab.object_id = fkc.referenced_object_id
+           JOIN sys.schemas rsch ON rsch.schema_id = rtab.schema_id
+           JOIN sys.columns rcol ON rcol.object_id = fkc.referenced_object_id
+                                AND rcol.column_id = fkc.referenced_column_id`
+    )
+  ]);
+  return assembleIntrospectedSchema({ colRows, pkRows, fkRows });
+}
+
 // ../connectors/src/connectors/azure-sql/index.ts
 init_mssql_runner();
 init_utils();
@@ -805,11 +1089,11 @@ init_utils();
 // ../connectors/src/connectors/azure-sql/setup.ts
 var azureSqlOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Use azure-sql_executeQuery to confirm the database flavor: \`SELECT @@VERSION\` (Azure SQL returns "Microsoft SQL Azure \u2026")
+    en: `1. Use connector_azure-sql_executeQuery to confirm the database flavor: \`SELECT @@VERSION\` (Azure SQL returns "Microsoft SQL Azure \u2026")
 2. List user tables: \`SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE = 'BASE TABLE' AND TABLE_SCHEMA NOT IN ('sys', 'INFORMATION_SCHEMA')\`
 3. For key tables, fetch column info: \`SELECT COLUMN_NAME, DATA_TYPE FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'dbo' AND TABLE_NAME = 'xxx'\`
 4. Sample up to 3 tables. Azure SQL is T-SQL, so use \`TOP\` rather than \`LIMIT\`: \`SELECT TOP 5 * FROM <schema>.<table_name>\``,
-    ja: `1. azure-sql_executeQuery \u3067\u30D5\u30EC\u30FC\u30D0\u30FC\u3092\u78BA\u8A8D: \`SELECT @@VERSION\`\uFF08Azure SQL \u306F "Microsoft SQL Azure \u2026" \u3092\u8FD4\u3057\u307E\u3059\uFF09
+    ja: `1. connector_azure-sql_executeQuery \u3067\u30D5\u30EC\u30FC\u30D0\u30FC\u3092\u78BA\u8A8D: \`SELECT @@VERSION\`\uFF08Azure SQL \u306F "Microsoft SQL Azure \u2026" \u3092\u8FD4\u3057\u307E\u3059\uFF09
 2. \u30E6\u30FC\u30B6\u30FC\u30C6\u30FC\u30D6\u30EB\u4E00\u89A7: \`SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE = 'BASE TABLE' AND TABLE_SCHEMA NOT IN ('sys', 'INFORMATION_SCHEMA')\`
 3. \u4E3B\u8981\u30C6\u30FC\u30D6\u30EB\u306E\u30AB\u30E9\u30E0\u60C5\u5831: \`SELECT COLUMN_NAME, DATA_TYPE FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'dbo' AND TABLE_NAME = 'xxx'\`
 4. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u6700\u59273\u30C6\u30FC\u30D6\u30EB\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u3002Azure SQL \u306F T-SQL \u306E\u305F\u3081 \`LIMIT\` \u3067\u306F\u306A\u304F \`TOP\` \u3092\u4F7F\u7528: \`SELECT TOP 5 * FROM <schema>.<table_name>\``
@@ -841,6 +1125,9 @@ var outputSchema = z.discriminatedUnion("success", [
   z.object({
     success: z.literal(true),
     rowCount: z.number(),
+    rowsAffected: z.number().optional().describe(
+      "Affected rows for INSERT/UPDATE/DELETE; undefined for SELECT"
+    ),
     truncated: z.boolean(),
     rows: z.array(z.record(z.string(), z.unknown()))
   }),
@@ -854,7 +1141,8 @@ var executeQueryTool = new ConnectorTool({
   description: `Execute a T-SQL query against Azure SQL Database. Returns up to ${MAX_ROWS} rows.
 Use for: schema exploration via \`INFORMATION_SCHEMA\`, data sampling, and analytical queries.
 Azure SQL is T-SQL: use \`TOP n\` instead of \`LIMIT n\`. Identifiers can be wrapped in square brackets.
-Avoid loading large amounts of data; always include \`TOP\` in queries.`,
+Avoid loading large amounts of data; always include \`TOP\` in queries.
+For INSERT/UPDATE/DELETE, \`rowCount\` is 0 and \`rows\` is empty (rowCount counts returned rows, not affected rows) \u2014 this is normal, not a failure; check \`rowsAffected\` for the number of affected rows.`,
   inputSchema,
   outputSchema,
   async execute({ connectionId, sql }, connections) {
@@ -881,7 +1169,7 @@ Avoid loading large amounts of data; always include \`TOP\` in queries.`,
       };
     }
     try {
-      const { rows } = await runMssqlQuery(parsed, sql, {
+      const { rows, rowsAffected } = await runMssqlQuery(parsed, sql, {
         forceEncrypt: true,
         tunnelParams: connectionParamsToRecord(connection2)
       });
@@ -889,6 +1177,9 @@ Avoid loading large amounts of data; always include \`TOP\` in queries.`,
       return {
         success: true,
         rowCount: Math.min(rows.length, MAX_ROWS),
+        // tedious counts SELECT result rows in rowsAffected too, so only
+        // report it for DML. Multi-statement batches are summed.
+        rowsAffected: isDmlStatement(sql) ? rowsAffected.reduce((sum, n) => sum + n, 0) : void 0,
         truncated,
         rows: rows.slice(0, MAX_ROWS)
       };
@@ -915,7 +1206,7 @@ var azureSqlConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`azure-sql_executeQuery\`: Executes a T-SQL query against Azure SQL Database and returns rows. Use for schema exploration via \`INFORMATION_SCHEMA\` and data sampling. See the SQL Reference below for Azure SQL-specific notes.
+- \`connector_azure-sql_executeQuery\`: Executes a T-SQL query against Azure SQL Database and returns rows. Use for schema exploration via \`INFORMATION_SCHEMA\` and data sampling. See the SQL Reference below for Azure SQL-specific notes.
 
 ### Business Logic
 
@@ -932,7 +1223,7 @@ The business logic type for this connector is "sql".
 - Row-limit compatibility: the platform's server-logic schema inference may wrap your query as \`SELECT * FROM (<inner>) AS _sq LIMIT N\`. T-SQL does not understand \`LIMIT\`, so the connector detects this exact wrapper at \`query()\` time, executes \`<inner>\` directly, and slices the first N rows in JS. You do not need to handle this \u2014 but do not author your own \`LIMIT\` clauses; use \`TOP\` / \`OFFSET ... FETCH NEXT\` in queries you write.`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`azure-sql_executeQuery\`: Azure SQL Database \u306B\u5BFE\u3057\u3066 T-SQL \u30AF\u30A8\u30EA\u3092\u5B9F\u884C\u3057\u3001\u884C\u30C7\u30FC\u30BF\u3092\u8FD4\u3057\u307E\u3059\u3002\`INFORMATION_SCHEMA\` \u3092\u4F7F\u3063\u305F\u30B9\u30AD\u30FC\u30DE\u63A2\u7D22\u3084\u30C7\u30FC\u30BF\u306E\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u306B\u4F7F\u3044\u307E\u3059\u3002Azure SQL \u56FA\u6709\u306E\u6CE8\u610F\u70B9\u306F\u4E0B\u90E8\u306E\u300CSQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \`connector_azure-sql_executeQuery\`: Azure SQL Database \u306B\u5BFE\u3057\u3066 T-SQL \u30AF\u30A8\u30EA\u3092\u5B9F\u884C\u3057\u3001\u884C\u30C7\u30FC\u30BF\u3092\u8FD4\u3057\u307E\u3059\u3002\`INFORMATION_SCHEMA\` \u3092\u4F7F\u3063\u305F\u30B9\u30AD\u30FC\u30DE\u63A2\u7D22\u3084\u30C7\u30FC\u30BF\u306E\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u306B\u4F7F\u3044\u307E\u3059\u3002Azure SQL \u56FA\u6709\u306E\u6CE8\u610F\u70B9\u306F\u4E0B\u90E8\u306E\u300CSQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 ### Business Logic
 
@@ -949,6 +1240,12 @@ The business logic type for this connector is "sql".
 - \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\u3002T-SQL \u306B\u306F \`LIMIT\` \u304C\u7121\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 \`TOP\` / \`OFFSET ... FETCH NEXT\` \u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002`
   },
   tools,
+  // 決定論的な立ち上げ survey（ルールベース prewarm）。Azure SQL はユーザーオブジェクトが既定 `dbo`、識別子は `[ ]`。
+  surveyProbes: makeStandardSqlSurveyProbes({
+    schemaLiteral: "dbo",
+    bracket: true
+  }),
+  introspect: (ctx) => withRowCounts(ctx, introspectMssql(ctx.query), quoteBracket),
   setup: (params, ctx, config) => runSetupFlow(azureSqlSetupFlow, params, ctx, config),
   async checkConnection(params, _config) {
     return checkMssqlConnection(