@squadbase/vite-server 0.1.17 → 0.1.19-dev.a00d9c3

package/dist/connectors/supabase.js

@@ -1,6 +1,11 @@
 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;
+  }
 };
 
 // ../connectors/src/parameter-definition.ts
@@ -169,6 +174,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
@@ -183,6 +197,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;
@@ -200,7 +222,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);
@@ -238,25 +262,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];
@@ -265,6 +289,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 = {
@@ -335,6 +437,58 @@ 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;
+function dq(ident) {
+  return `"${ident.replace(/"/g, '""')}"`;
+}
+var quoteAnsi = (schema, name) => [...schema.split("."), name].map(dq).join(".");
+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",
@@ -360,6 +514,116 @@ function buildPositionalParams(sql, namedParams) {
   return { text, values };
 }
 
+// ../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/connectors/postgresql/introspect.ts
+async function introspectPostgresql(run) {
+  const SCHEMA_FILTER = `c.table_schema NOT IN ('pg_catalog', 'information_schema') AND c.table_schema NOT LIKE 'pg\\_%'`;
+  const [{ rows: colRows }, { rows: pkRows }, { rows: fkRows }] = await Promise.all([
+    // 1) 全カラム（型 / nullable）+ テーブル種別（BASE TABLE / VIEW）
+    run(
+      `SELECT c.table_schema, c.table_name, c.column_name, c.data_type,
+                c.is_nullable, c.ordinal_position, t.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 ${SCHEMA_FILTER}
+          ORDER BY c.table_schema, c.table_name, c.ordinal_position`
+    ),
+    // 2) 主キー（schema.table.column）
+    run(
+      `SELECT tc.table_schema, tc.table_name, kcu.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
+          WHERE tc.constraint_type = 'PRIMARY KEY'
+            AND tc.table_schema NOT IN ('pg_catalog', 'information_schema')
+            AND tc.table_schema NOT LIKE 'pg\\_%'`
+    ),
+    // 3) 外部キー（参照元 → 参照先）。
+    // 複合 FK を正しく対応付けるため、`constraint_column_usage`（順序非保証 + constraint_name のみの
+    // join で複合キーが直積爆発する）を使わず、`referential_constraints` 経由で参照先 unique 制約へ辿り、
+    // FK 列の `position_in_unique_constraint` を参照先列の `ordinal_position` に突き合わせて 1:1 に組む。
+    run(
+      `SELECT tc.table_schema, tc.table_name, kcu.column_name,
+                fkcu.table_schema AS foreign_table_schema,
+                fkcu.table_name   AS foreign_table_name,
+                fkcu.column_name  AS foreign_column_name
+           FROM information_schema.table_constraints tc
+           JOIN information_schema.key_column_usage kcu
+             ON kcu.constraint_name = tc.constraint_name
+            AND kcu.constraint_schema = tc.constraint_schema
+           JOIN information_schema.referential_constraints rc
+             ON rc.constraint_name = tc.constraint_name
+            AND rc.constraint_schema = tc.constraint_schema
+           JOIN information_schema.key_column_usage fkcu
+             ON fkcu.constraint_name = rc.unique_constraint_name
+            AND fkcu.constraint_schema = rc.unique_constraint_schema
+            AND fkcu.ordinal_position = kcu.position_in_unique_constraint
+          WHERE tc.constraint_type = 'FOREIGN KEY'
+            AND tc.table_schema NOT IN ('pg_catalog', 'information_schema')
+            AND tc.table_schema NOT LIKE 'pg\\_%'`
+    )
+  ]);
+  return assembleIntrospectedSchema({ colRows, pkRows, fkRows });
+}
+
 // ../connectors/src/connectors/supabase/setup.ts
 var supabaseOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
@@ -537,6 +801,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()))
   }),
@@ -550,7 +817,8 @@ var executeQueryTool = new ConnectorTool({
   description: `Execute SQL against a Supabase Postgres database. Returns up to ${MAX_ROWS} rows.
 Use for: schema exploration (information_schema), data sampling, and analytical queries against Supabase tables.
 User tables live in the \`public\` schema by default; Supabase-managed metadata lives in \`auth\` and \`storage\`.
-Avoid loading large amounts of data; always include LIMIT in queries.`,
+Avoid loading large amounts of data; always include LIMIT 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. Use RETURNING to get written rows back in \`rows\`.`,
   inputSchema,
   outputSchema,
   async execute({ connectionId, sql }, connections) {
@@ -578,9 +846,13 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
         const result = await pool.query(sql);
         const rows = result.rows;
         const truncated = rows.length > MAX_ROWS;
+        const isDml = ["INSERT", "UPDATE", "DELETE", "MERGE"].includes(
+          result.command
+        );
         return {
           success: true,
           rowCount: Math.min(rows.length, MAX_ROWS),
+          rowsAffected: isDml ? result.rowCount ?? 0 : void 0,
           truncated,
           rows: rows.slice(0, MAX_ROWS)
         };
@@ -646,6 +918,11 @@ The business logic type for this connector is "sql".
 - \u30AF\u30A8\u30EA\u306B\u306F\u5FC5\u305A LIMIT \u3092\u542B\u3081\u3066\u304F\u3060\u3055\u3044`
   },
   tools,
+  // 決定論的な立ち上げ survey（ルールベース prewarm）。Supabase は Postgres で公開スキーマは `public`。
+  surveyProbes: makeStandardSqlSurveyProbes({ schemaLiteral: "public" }),
+  // Supabase は PostgreSQL なので postgresql の introspect をそのまま流用する
+  // （exploreData / DataContextIndex の対象に含めるため）。
+  introspect: (ctx) => withRowCounts(ctx, introspectPostgresql(ctx.query), quoteAnsi),
   setup: (params, ctx, config) => runSetupFlow(supabaseSetupFlow, params, ctx, config),
   async checkConnection(params, _config) {
     const { Pool } = await import("pg");

package/dist/connectors/tableau.js

@@ -1,6 +1,11 @@
 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;
+  }
 };
 
 // ../connectors/src/parameter-definition.ts
@@ -266,6 +271,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
@@ -280,6 +294,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;
@@ -297,7 +319,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);
@@ -335,25 +359,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];
@@ -917,7 +941,7 @@ var tableauConnector = new ConnectorPlugin({
   description: "Connect to Tableau Cloud or Tableau Server via a Personal Access Token (PAT). Use it to enumerate projects, workbooks, views, and data sources, and to pull view data.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/3ejrZvfw7zCDa3FPbUNQx9/d810e117b3a86c45dd96205453bf67a0/tableau-icon.svg",
   parameters,
-  releaseFlag: { dev1: true, dev2: false, prod: false },
+  releaseFlag: { dev1: true, dev2: true, prod: true },
   categories: ["bi"],
   onboarding: tableauOnboarding,
   systemPrompt: {

package/dist/connectors/tiktok-ads.js

@@ -1,6 +1,11 @@
 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;
+  }
 };
 
 // ../connectors/src/parameter-definition.ts
@@ -132,6 +137,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
@@ -146,6 +160,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;
@@ -163,7 +185,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);
@@ -201,25 +225,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];