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

package/dist/connectors/intercom.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
@@ -236,6 +241,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
@@ -250,6 +264,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;
@@ -267,7 +289,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,25 +329,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];

package/dist/connectors/jdbc.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)
@@ -990,6 +995,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
@@ -1004,6 +1018,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;
@@ -1021,7 +1043,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);
@@ -1059,25 +1083,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];

package/dist/connectors/jira-api-key.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
@@ -185,6 +190,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
@@ -199,6 +213,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;
@@ -216,7 +238,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);
@@ -254,25 +278,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];

package/dist/connectors/kintone-api-token.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
@@ -214,6 +219,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
@@ -228,6 +242,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;
@@ -245,7 +267,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);
@@ -283,25 +307,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];

package/dist/connectors/kintone.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
@@ -223,6 +228,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
@@ -237,6 +251,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;
@@ -254,7 +276,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);
@@ -292,25 +316,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];
@@ -389,6 +413,24 @@ 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/auth-types.ts
 var AUTH_TYPES = {
   OAUTH: "oauth",
@@ -570,6 +612,45 @@ var kintoneSetupFlow = {
   }
 };
 
+// ../connectors/src/connectors/kintone/introspect.ts
+var MAX_APPS = 100;
+var CONCURRENCY = 5;
+async function introspectKintone(ctx) {
+  const appsRes = await apiFetch(ctx.params, "apps.json");
+  if (!appsRes.ok) {
+    throw new Error(`kintone: apps.json failed (${appsRes.status})`);
+  }
+  const appsData = await appsRes.json();
+  const apps = (appsData.apps ?? []).slice(0, MAX_APPS);
+  const tables = (await mapWithConcurrency(apps, CONCURRENCY, async (app) => {
+    try {
+      const res = await apiFetch(
+        ctx.params,
+        `app/form/fields.json?app=${encodeURIComponent(app.appId)}`
+      );
+      if (!res.ok) return [];
+      const data = await res.json();
+      const columns = Object.values(
+        data.properties ?? {}
+      ).filter((f) => f.code || f.label).map((f) => ({
+        name: f.code || f.label || "",
+        dataType: f.type ?? "UNKNOWN",
+        nullable: f.required !== true
+      }));
+      const table = {
+        schema: String(app.appId),
+        name: app.name,
+        type: "table",
+        columns
+      };
+      return [table];
+    } catch {
+      return [];
+    }
+  })).flat();
+  return { tables };
+}
+
 // ../connectors/src/connectors/kintone/tools/request.ts
 import { z } from "zod";
 var REQUEST_TIMEOUT_MS = 6e4;
@@ -791,6 +872,38 @@ export default async function handler(c: Context) {
 - \u6587\u5B57\u5217: \`like "\u90E8\u5206\u4E00\u81F4"\``
   },
   tools,
+  // 決定論的な立ち上げ survey（ルールベース prewarm）。round1: `apps.json` でアプリ一覧 → round2: 先頭アプリの
+  // フィールド定義を read-only GET（kintone の「テーブル」= アプリ）。
+  surveyProbes: (_connectionId, prior) => {
+    if (prior.length === 0) {
+      return [
+        {
+          tool: "request",
+          input: {
+            method: "GET",
+            path: "apps.json",
+            toolUseIntent: "List kintone apps"
+          }
+        }
+      ];
+    }
+    if (prior.length === 1) {
+      const out = prior[0]?.output;
+      const apps = out?.success !== false ? out?.data?.apps ?? [] : [];
+      return apps.map((a) => a.appId).filter(
+        (id) => typeof id === "string" || typeof id === "number"
+      ).slice(0, 3).map((appId) => ({
+        tool: "request",
+        input: {
+          method: "GET",
+          path: `app/form/fields.json?app=${appId}`,
+          toolUseIntent: `Fields for app ${appId}`
+        }
+      }));
+    }
+    return [];
+  },
+  introspect: (ctx) => introspectKintone(ctx),
   setup: (params, ctx, config) => runSetupFlow(kintoneSetupFlow, params, ctx, config),
   async checkConnection(params, _config) {
     const baseUrl = params[parameters.baseUrl.slug];

package/dist/connectors/linear.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
@@ -229,6 +234,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
@@ -243,6 +257,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;
@@ -260,7 +282,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);
@@ -298,25 +322,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];