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

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);
@@ -208,7 +232,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(
@@ -218,7 +242,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) {
@@ -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: {
@@ -469,6 +733,21 @@ var supabaseSetupFlow = {
       fetchAll: () => fetchTableNames(rt.params, schema),
       limit: SUPABASE_SETUP_MAX_TABLES
     });
+    let rowCounts = /* @__PURE__ */ new Map();
+    try {
+      const countRows = await runQuery(
+        rt.params,
+        `SELECT relname, n_live_tup FROM pg_stat_user_tables WHERE schemaname = $1`,
+        [schema]
+      );
+      rowCounts = new Map(
+        countRows.map((r) => [
+          String(r["relname"] ?? ""),
+          Number(r["n_live_tup"] ?? 0)
+        ])
+      );
+    } catch {
+    }
     const sections = [
       "## Supabase",
       "",
@@ -484,7 +763,9 @@ var supabaseSetupFlow = {
          ORDER BY ordinal_position`,
         [schema, table]
       );
-      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) {
@@ -520,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()))
   }),
@@ -533,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) {
@@ -561,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)
         };
@@ -595,7 +884,7 @@ var supabaseConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`supabase_executeQuery\`: Executes a PostgreSQL query against the Supabase project's database and returns rows. Use this for schema exploration via \`information_schema.tables\`/\`columns\` and for sampling data. See the SQL Reference below for syntax notes and Supabase-specific schemas.
+- \`connector_supabase_executeQuery\`: Executes a PostgreSQL query against the Supabase project's database and returns rows. Use this for schema exploration via \`information_schema.tables\`/\`columns\` and for sampling data. See the SQL Reference below for syntax notes and Supabase-specific schemas.
 
 ### Business Logic
 
@@ -612,7 +901,7 @@ The business logic type for this connector is "sql".
 - Always include LIMIT in queries`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`supabase_executeQuery\`: Supabase\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E Postgres \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u306B\u5BFE\u3057\u3066\u30AF\u30A8\u30EA\u3092\u5B9F\u884C\u3057\u3001\u884C\u30C7\u30FC\u30BF\u3092\u8FD4\u3057\u307E\u3059\u3002\`information_schema.tables\`/\`columns\` \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\u3002\u69CB\u6587\u306E\u6CE8\u610F\u70B9\u3068 Supabase \u56FA\u6709\u306E\u30B9\u30AD\u30FC\u30DE\u306F\u4E0B\u90E8\u306E\u300CSQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \`connector_supabase_executeQuery\`: Supabase\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E Postgres \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u306B\u5BFE\u3057\u3066\u30AF\u30A8\u30EA\u3092\u5B9F\u884C\u3057\u3001\u884C\u30C7\u30FC\u30BF\u3092\u8FD4\u3057\u307E\u3059\u3002\`information_schema.tables\`/\`columns\` \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\u3002\u69CB\u6587\u306E\u6CE8\u610F\u70B9\u3068 Supabase \u56FA\u6709\u306E\u30B9\u30AD\u30FC\u30DE\u306F\u4E0B\u90E8\u306E\u300CSQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 ### Business Logic
 
@@ -629,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);
@@ -305,7 +329,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(
@@ -315,7 +339,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) {
@@ -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];
@@ -447,7 +471,7 @@ var tableauOnboarding = new ConnectorOnboarding({
   connectionSetupInstructions: {
     en: `Follow these steps to verify the Tableau PAT connection.
 
-1. Call \`tableau_request\` with \`method: "GET"\` and \`path: "/sites/{siteId}/projects?pageSize=5"\` to list a few projects on the signed-in site
+1. Call \`connector_tableau_request\` with \`method: "GET"\` and \`path: "/sites/{siteId}/projects?pageSize=5"\` to list a few projects on the signed-in site
 2. If the call fails with HTTP 401, ask the user to confirm the PAT name/secret and that the Site Content URL matches the site where the PAT was issued (Tableau Cloud sites are case-sensitive)
 
 #### Constraints
@@ -455,7 +479,7 @@ var tableauOnboarding = new ConnectorOnboarding({
 - The literal placeholder \`{siteId}\` in the path is automatically replaced with the session's site ID \u2014 do NOT hardcode the ID`,
     ja: `Tableau PAT \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u306F\u4EE5\u4E0B\u306E\u624B\u9806\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
 
-1. \`tableau_request\` \u3092 \`method: "GET"\`\u3001\`path: "/sites/{siteId}/projects?pageSize=5"\` \u3067\u547C\u3073\u51FA\u3057\u3001\u30B5\u30A4\u30F3\u30A4\u30F3\u5148\u30B5\u30A4\u30C8\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u3044\u304F\u3064\u304B\u53D6\u5F97\u3059\u308B
+1. \`connector_tableau_request\` \u3092 \`method: "GET"\`\u3001\`path: "/sites/{siteId}/projects?pageSize=5"\` \u3067\u547C\u3073\u51FA\u3057\u3001\u30B5\u30A4\u30F3\u30A4\u30F3\u5148\u30B5\u30A4\u30C8\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u3044\u304F\u3064\u304B\u53D6\u5F97\u3059\u308B
 2. HTTP 401 \u3067\u5931\u6557\u3057\u305F\u5834\u5408\u306F\u3001PAT \u540D/\u30B7\u30FC\u30AF\u30EC\u30C3\u30C8\u304A\u3088\u3073 Site Content URL \u304C PAT \u767A\u884C\u30B5\u30A4\u30C8\u3068\u4E00\u81F4\u3057\u3066\u3044\u308B\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B\uFF08Tableau Cloud \u306E\u30B5\u30A4\u30C8\u540D\u306F\u5927\u6587\u5B57\u5C0F\u6587\u5B57\u3092\u533A\u5225\uFF09
 
 #### \u5236\u7D04
@@ -463,14 +487,14 @@ var tableauOnboarding = new ConnectorOnboarding({
 - \u30D1\u30B9\u5185\u306E\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC \`{siteId}\` \u306F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059 \u2014 ID \u3092\u30CF\u30FC\u30C9\u30B3\u30FC\u30C9\u3057\u306A\u3044\u3053\u3068`
   },
   dataOverviewInstructions: {
-    en: `1. Call tableau_request with GET /sites/{siteId}/projects to list projects
-2. Call tableau_request with GET /sites/{siteId}/workbooks?pageSize=20 to list workbooks
-3. For a target workbook, call tableau_request with GET /sites/{siteId}/workbooks/{workbookId}/views to list its views
-4. Call tableau_request with GET /sites/{siteId}/datasources?pageSize=20 to list published data sources`,
-    ja: `1. tableau_request \u3067 GET /sites/{siteId}/projects \u3092\u547C\u3073\u51FA\u3057\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
-2. tableau_request \u3067 GET /sites/{siteId}/workbooks?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u4E00\u89A7\u3092\u53D6\u5F97
-3. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u306B\u3064\u3044\u3066 tableau_request \u3067 GET /sites/{siteId}/workbooks/{workbookId}/views \u3092\u547C\u3073\u51FA\u3057\u3001\u30D3\u30E5\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
-4. tableau_request \u3067 GET /sites/{siteId}/datasources?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u516C\u958B\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97`
+    en: `1. Call connector_tableau_request with GET /sites/{siteId}/projects to list projects
+2. Call connector_tableau_request with GET /sites/{siteId}/workbooks?pageSize=20 to list workbooks
+3. For a target workbook, call connector_tableau_request with GET /sites/{siteId}/workbooks/{workbookId}/views to list its views
+4. Call connector_tableau_request with GET /sites/{siteId}/datasources?pageSize=20 to list published data sources`,
+    ja: `1. connector_tableau_request \u3067 GET /sites/{siteId}/projects \u3092\u547C\u3073\u51FA\u3057\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+2. connector_tableau_request \u3067 GET /sites/{siteId}/workbooks?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u4E00\u89A7\u3092\u53D6\u5F97
+3. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u306B\u3064\u3044\u3066 connector_tableau_request \u3067 GET /sites/{siteId}/workbooks/{workbookId}/views \u3092\u547C\u3073\u51FA\u3057\u3001\u30D3\u30E5\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
+4. connector_tableau_request \u3067 GET /sites/{siteId}/datasources?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u516C\u958B\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97`
   }
 });
 
@@ -917,13 +941,13 @@ 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: {
     en: `### Tools
 
-- \`tableau_request\`: The only way to call the Tableau REST API. Use it for projects, workbooks, views, data sources, users, and permissions. The \`X-Tableau-Auth\` token is issued and managed centrally by the Squadbase backend so concurrent processes (chat & deployed app) share a single PAT sign-in. Use the literal \`{siteId}\` placeholder in the path \u2014 it is replaced with the session's site ID automatically.
+- \`connector_tableau_request\`: The only way to call the Tableau REST API. Use it for projects, workbooks, views, data sources, users, and permissions. The \`X-Tableau-Auth\` token is issued and managed centrally by the Squadbase backend so concurrent processes (chat & deployed app) share a single PAT sign-in. Use the literal \`{siteId}\` placeholder in the path \u2014 it is replaced with the session's site ID automatically.
 
 ### Business Logic
 
@@ -980,7 +1004,7 @@ export default async function handler(c: Context) {
 - Combine: \`filter=ownerName:eq:alice,tags:in:[finance]\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`tableau_request\`: Tableau REST API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u3001\u30D3\u30E5\u30FC\u3001\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u6A29\u9650\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\`X-Tableau-Auth\` \u30C8\u30FC\u30AF\u30F3\u306F Squadbase \u30D0\u30C3\u30AF\u30A8\u30F3\u30C9\u3067\u4E00\u5143\u7BA1\u7406\u3055\u308C\u3001\u8907\u6570\u30D7\u30ED\u30BB\u30B9 (\u30C1\u30E3\u30C3\u30C8\u30FB\u30C7\u30D7\u30ED\u30A4\u6E08\u307F\u30A2\u30D7\u30EA) \u3067\u540C\u3058 PAT \u30B5\u30A4\u30F3\u30A4\u30F3\u3092\u5171\u6709\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306B\u306F \`{siteId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044 \u2014 \u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
+- \`connector_tableau_request\`: Tableau REST API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u3001\u30D3\u30E5\u30FC\u3001\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u6A29\u9650\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\`X-Tableau-Auth\` \u30C8\u30FC\u30AF\u30F3\u306F Squadbase \u30D0\u30C3\u30AF\u30A8\u30F3\u30C9\u3067\u4E00\u5143\u7BA1\u7406\u3055\u308C\u3001\u8907\u6570\u30D7\u30ED\u30BB\u30B9 (\u30C1\u30E3\u30C3\u30C8\u30FB\u30C7\u30D7\u30ED\u30A4\u6E08\u307F\u30A2\u30D7\u30EA) \u3067\u540C\u3058 PAT \u30B5\u30A4\u30F3\u30A4\u30F3\u3092\u5171\u6709\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306B\u306F \`{siteId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044 \u2014 \u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
 
 ### Business Logic