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

package/dist/connectors/hubspot-oauth.js

@@ -75,6 +75,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
@@ -89,6 +98,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;
@@ -106,7 +123,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);
@@ -114,7 +133,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(
@@ -124,7 +143,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) {
@@ -144,25 +163,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];
@@ -392,11 +411,11 @@ var hubspotOnboarding = new ConnectorOnboarding({
 - Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`
   },
   dataOverviewInstructions: {
-    en: `1. Call hubspot-oauth_request with GET /crm/v3/objects/contacts?limit=5 to explore contacts structure
-2. Call hubspot-oauth_request with GET /crm/v3/objects/deals?limit=5 to explore deals structure
+    en: `1. Call connector_hubspot-oauth_request with GET /crm/v3/objects/contacts?limit=5 to explore contacts structure
+2. Call connector_hubspot-oauth_request with GET /crm/v3/objects/deals?limit=5 to explore deals structure
 3. Explore other object types (companies, etc.) as needed to understand available data`,
-    ja: `1. hubspot-oauth_request \u3067 GET /crm/v3/objects/contacts?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30B3\u30F3\u30BF\u30AF\u30C8\u306E\u69CB\u9020\u3092\u78BA\u8A8D
-2. hubspot-oauth_request \u3067 GET /crm/v3/objects/deals?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u53D6\u5F15\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+    ja: `1. connector_hubspot-oauth_request \u3067 GET /crm/v3/objects/contacts?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30B3\u30F3\u30BF\u30AF\u30C8\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+2. connector_hubspot-oauth_request \u3067 GET /crm/v3/objects/deals?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u53D6\u5F15\u306E\u69CB\u9020\u3092\u78BA\u8A8D
 3. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u4ED6\u306E\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u30BF\u30A4\u30D7\uFF08\u4F01\u696D\u306A\u3069\uFF09\u3092\u63A2\u7D22\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30C7\u30FC\u30BF\u3092\u628A\u63E1`
   }
 });
@@ -434,6 +453,19 @@ async function listProperties(proxyFetch, objectType) {
   const data = await res.json();
   return data.results ?? [];
 }
+async function fetchObjectCount(proxyFetch, objectType) {
+  try {
+    const res = await apiFetch(
+      proxyFetch,
+      `/crm/v3/objects/${objectType}?limit=1`
+    );
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data.total === "number" ? data.total : null;
+  } catch {
+    return null;
+  }
+}
 var hubspotOauthSetupFlow = {
   initialState: () => ({}),
   steps: [
@@ -464,8 +496,27 @@ var hubspotOauthSetupFlow = {
       limit: HUBSPOT_SETUP_MAX_OBJECT_TYPES
     });
     const sections = ["## HubSpot", ""];
+    const countByType = /* @__PURE__ */ new Map();
+    for (const objectType of targetObjectTypes) {
+      countByType.set(
+        objectType,
+        await fetchObjectCount(rt.config.proxyFetch, objectType)
+      );
+    }
+    sections.push("### Record counts", "");
+    sections.push("| Object type | Record count |");
+    sections.push("|-------------|-------------|");
+    for (const objectType of targetObjectTypes) {
+      const count = countByType.get(objectType);
+      sections.push(
+        `| ${objectType} | ${count == null ? "-" : count.toLocaleString()} |`
+      );
+    }
+    sections.push("");
     for (const objectType of targetObjectTypes) {
-      sections.push(`### Object: ${objectType}`, "");
+      const count = countByType.get(objectType);
+      const countLabel = count == null ? "" : ` (${count.toLocaleString()} records)`;
+      sections.push(`### Object: ${objectType}${countLabel}`, "");
       const props = await listProperties(rt.config.proxyFetch, objectType);
       const limited = props.slice(0, HUBSPOT_SETUP_MAX_PROPERTIES);
       sections.push("| Property | Type | Label |");
@@ -515,7 +566,7 @@ var hubspotOauthConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`hubspot-oauth_request\`: The only way to call the HubSpot API. Use it to query contacts, deals, companies, and other CRM objects. Authentication is configured automatically via OAuth. HubSpot uses cursor-based pagination with the \`after\` parameter from \`paging.next.after\` in the response.
+- \`connector_hubspot-oauth_request\`: The only way to call the HubSpot API. Use it to query contacts, deals, companies, and other CRM objects. Authentication is configured automatically via OAuth. HubSpot uses cursor-based pagination with the \`after\` parameter from \`paging.next.after\` in the response.
 
 ### HubSpot API Reference
 
@@ -560,7 +611,7 @@ const data = await res.json();
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`hubspot-oauth_request\`: HubSpot API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30B3\u30F3\u30BF\u30AF\u30C8\u3001\u53D6\u5F15\u3001\u4F1A\u793E\u3001\u305D\u306E\u4ED6\u306ECRM\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002HubSpot\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`paging.next.after\` \u304B\u3089\u306E \`after\` \u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
+- \`connector_hubspot-oauth_request\`: HubSpot API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30B3\u30F3\u30BF\u30AF\u30C8\u3001\u53D6\u5F15\u3001\u4F1A\u793E\u3001\u305D\u306E\u4ED6\u306ECRM\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002HubSpot\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`paging.next.after\` \u304B\u3089\u306E \`after\` \u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
 
 ### HubSpot API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 

package/dist/connectors/hubspot.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
@@ -218,6 +223,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
@@ -232,6 +246,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;
@@ -249,7 +271,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);
@@ -257,7 +281,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(
@@ -267,7 +291,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) {
@@ -287,25 +311,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];
@@ -397,11 +421,11 @@ var AUTH_TYPES = {
 // ../connectors/src/connectors/hubspot/setup.ts
 var hubspotOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Call hubspot_request with GET /crm/v3/objects/contacts?limit=5 to explore contacts structure
-2. Call hubspot_request with GET /crm/v3/objects/deals?limit=5 to explore deals structure
+    en: `1. Call connector_hubspot_request with GET /crm/v3/objects/contacts?limit=5 to explore contacts structure
+2. Call connector_hubspot_request with GET /crm/v3/objects/deals?limit=5 to explore deals structure
 3. Explore other object types (companies, tickets, etc.) as needed to understand available data`,
-    ja: `1. hubspot_request \u3067 GET /crm/v3/objects/contacts?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30B3\u30F3\u30BF\u30AF\u30C8\u306E\u69CB\u9020\u3092\u78BA\u8A8D
-2. hubspot_request \u3067 GET /crm/v3/objects/deals?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u53D6\u5F15\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+    ja: `1. connector_hubspot_request \u3067 GET /crm/v3/objects/contacts?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30B3\u30F3\u30BF\u30AF\u30C8\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+2. connector_hubspot_request \u3067 GET /crm/v3/objects/deals?limit=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u53D6\u5F15\u306E\u69CB\u9020\u3092\u78BA\u8A8D
 3. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u4ED6\u306E\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u30BF\u30A4\u30D7\uFF08\u4F01\u696D\u3001\u30C1\u30B1\u30C3\u30C8\u306A\u3069\uFF09\u3092\u63A2\u7D22\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30C7\u30FC\u30BF\u3092\u628A\u63E1`
   }
 });
@@ -435,6 +459,20 @@ var HUBSPOT_OBJECT_TYPES = [
   { value: "meetings", label: "Meetings" },
   { value: "tasks", label: "Tasks" }
 ];
+async function countObjects(params, objectType) {
+  try {
+    const res = await apiFetch(params, `/crm/v3/objects/${objectType}/search`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ limit: 1 })
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data.total === "number" ? data.total : null;
+  } catch {
+    return null;
+  }
+}
 async function listProperties(params, objectType) {
   const res = await apiFetch(params, `/crm/v3/properties/${objectType}`);
   if (!res.ok) {
@@ -479,7 +517,9 @@ var hubspotSetupFlow = {
     });
     const sections = ["## HubSpot", ""];
     for (const objectType of targetObjectTypes) {
-      sections.push(`### Object: ${objectType}`, "");
+      const count = await countObjects(rt.params, objectType);
+      const heading = count != null ? `### Object: ${objectType} (${count.toLocaleString()} records)` : `### Object: ${objectType}`;
+      sections.push(heading, "");
       const props = await listProperties(rt.params, objectType);
       const limited = props.slice(0, HUBSPOT_SETUP_MAX_PROPERTIES);
       sections.push("| Property | Type | Label |");
@@ -595,7 +635,7 @@ var hubspotConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`hubspot_request\`: The only way to call the HubSpot API. Use it to query contacts, deals, companies, tickets, and other CRM objects. Authentication (Bearer token) is configured automatically. HubSpot uses cursor-based pagination with the \`after\` parameter from \`paging.next.after\` in the response. Use the search endpoint for complex queries with filters.
+- \`connector_hubspot_request\`: The only way to call the HubSpot API. Use it to query contacts, deals, companies, tickets, and other CRM objects. Authentication (Bearer token) is configured automatically. HubSpot uses cursor-based pagination with the \`after\` parameter from \`paging.next.after\` in the response. Use the search endpoint for complex queries with filters.
 
 ### Business Logic
 
@@ -661,7 +701,7 @@ export default async function handler(c: Context) {
 - \`after\` \u2014 Pagination offset`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`hubspot_request\`: HubSpot API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30B3\u30F3\u30BF\u30AF\u30C8\u3001\u53D6\u5F15\u3001\u4F1A\u793E\u3001\u30C1\u30B1\u30C3\u30C8\u3001\u305D\u306E\u4ED6\u306ECRM\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Bearer\u30C8\u30FC\u30AF\u30F3\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002HubSpot\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`paging.next.after\` \u304B\u3089\u306E \`after\` \u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002\u8907\u96D1\u306A\u30AF\u30A8\u30EA\u306B\u306F\u30D5\u30A3\u30EB\u30BF\u4ED8\u304D\u306Esearch\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
+- \`connector_hubspot_request\`: HubSpot API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30B3\u30F3\u30BF\u30AF\u30C8\u3001\u53D6\u5F15\u3001\u4F1A\u793E\u3001\u30C1\u30B1\u30C3\u30C8\u3001\u305D\u306E\u4ED6\u306ECRM\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Bearer\u30C8\u30FC\u30AF\u30F3\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002HubSpot\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`paging.next.after\` \u304B\u3089\u306E \`after\` \u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002\u8907\u96D1\u306A\u30AF\u30A8\u30EA\u306B\u306F\u30D5\u30A3\u30EB\u30BF\u4ED8\u304D\u306Esearch\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
 
 ### Business Logic
 

package/dist/connectors/influxdb.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
@@ -277,6 +282,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
@@ -291,6 +305,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;
@@ -308,7 +330,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);
@@ -316,7 +340,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(
@@ -326,7 +350,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) {
@@ -346,25 +370,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];
@@ -486,7 +510,7 @@ var influxdbOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
     en: `The instance may be either InfluxDB 3 (supports SQL) or InfluxDB 2 (Flux only; includes InfluxDB Cloud on '*.cloud2.influxdata.com'). Detect the variant first, then pick the matching endpoints.
 
-1. Probe for InfluxDB 3: call influxdb_request with POST /api/v3/query_sql, body { "db": "<database>", "q": "SELECT 1" }
+1. Probe for InfluxDB 3: call connector_influxdb_request with POST /api/v3/query_sql, body { "db": "<database>", "q": "SELECT 1" }
    - 200 with JSON rows \u2192 InfluxDB 3. Continue with SQL.
    - 405 Method Not Allowed, or an HTML body like "<html>...405 Not Allowed..." \u2192 InfluxDB 2. Fall back to Flux (step 3).
 2. InfluxDB 3 data overview:
@@ -498,7 +522,7 @@ var influxdbOnboarding = new ConnectorOnboarding({
    - If the Organization parameter was not provided but v3 probing failed, ask the user to set it using updateConnectionParameters before continuing.`,
     ja: `\u63A5\u7D9A\u5148\u306F InfluxDB 3\uFF08SQL \u5BFE\u5FDC\uFF09\u3068 InfluxDB 2\uFF08Flux \u306E\u307F\u3002\`*.cloud2.influxdata.com\` \u306E InfluxDB Cloud \u3092\u542B\u3080\uFF09\u306E\u3069\u3061\u3089\u306E\u53EF\u80FD\u6027\u3082\u3042\u308A\u307E\u3059\u3002\u307E\u305A\u30D0\u30EA\u30A2\u30F3\u30C8\u3092\u5224\u5225\u3057\u3001\u305D\u308C\u306B\u5408\u3046\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
-1. InfluxDB 3 \u306E\u5224\u5225: influxdb_request \u3067 POST /api/v3/query_sql\u3001body { "db": "<database>", "q": "SELECT 1" } \u3092\u5B9F\u884C
+1. InfluxDB 3 \u306E\u5224\u5225: connector_influxdb_request \u3067 POST /api/v3/query_sql\u3001body { "db": "<database>", "q": "SELECT 1" } \u3092\u5B9F\u884C
    - 200 + JSON \u884C\u304C\u8FD4\u308B \u2192 InfluxDB 3\u3002\u305D\u306E\u307E\u307E SQL \u3067\u7D9A\u884C\u3002
    - 405 Method Not Allowed\u3001\u307E\u305F\u306F "<html>...405 Not Allowed..." \u306E\u3088\u3046\u306A HTML \u672C\u6587\u304C\u8FD4\u308B \u2192 InfluxDB 2\u3002Flux \u306B\u30D5\u30A9\u30FC\u30EB\u30D0\u30C3\u30AF\uFF08\u624B\u9806 3\uFF09\u3002
 2. InfluxDB 3 \u306E\u5834\u5408\u306E\u30C7\u30FC\u30BF\u6982\u8981:
@@ -875,13 +899,13 @@ var influxdbConnector = new ConnectorPlugin({
 
 The configured instance may be **InfluxDB 3** (supports SQL via \`/api/v3/query_sql\`) or **InfluxDB 2** (Flux only; includes InfluxDB Cloud on \`*.cloud2.influxdata.com\`). Always probe first, then use the matching endpoints:
 
-1. Call \`influxdb_request\` POST \`/api/v3/query_sql\` with body \`{ "db": "<database>", "q": "SELECT 1" }\`
+1. Call \`connector_influxdb_request\` POST \`/api/v3/query_sql\` with body \`{ "db": "<database>", "q": "SELECT 1" }\`
 2. 200 + JSON rows \u2192 InfluxDB 3. Use SQL endpoints.
 3. 405 Method Not Allowed or HTML body (e.g. \`<html>...405 Not Allowed...</html>\`) \u2192 InfluxDB 2. Use Flux via \`/api/v2/query?org={org}\`. Require the \`org\` parameter; if missing, ask the user via \`updateConnectionParameters\`.
 
 ### Tools
 
-- \`influxdb_request\`: The only way to call the InfluxDB HTTP API. Use it to run SQL / InfluxQL / Flux queries, write line protocol, and inspect buckets / databases. Authentication (\`Authorization: Token {token}\`) and the instance URL are configured automatically. On InfluxDB 3 prefer SQL (\`POST /api/v3/query_sql\`) \u2014 it returns JSON rows that are directly usable. On InfluxDB 2 use Flux (\`POST /api/v2/query?org={org}\`) \u2014 the response is annotated CSV. Writes use \`POST /api/v3/write_lp?db={db}\` (v3) or \`POST /api/v2/write?org={org}&bucket={bucket}\` (v2) with a line-protocol body and \`contentType\` set to \`text/plain; charset=utf-8\`.
+- \`connector_influxdb_request\`: The only way to call the InfluxDB HTTP API. Use it to run SQL / InfluxQL / Flux queries, write line protocol, and inspect buckets / databases. Authentication (\`Authorization: Token {token}\`) and the instance URL are configured automatically. On InfluxDB 3 prefer SQL (\`POST /api/v3/query_sql\`) \u2014 it returns JSON rows that are directly usable. On InfluxDB 2 use Flux (\`POST /api/v2/query?org={org}\`) \u2014 the response is annotated CSV. Writes use \`POST /api/v3/write_lp?db={db}\` (v3) or \`POST /api/v2/write?org={org}&bucket={bucket}\` (v2) with a line-protocol body and \`contentType\` set to \`text/plain; charset=utf-8\`.
 
 ### Business Logic
 
@@ -946,13 +970,13 @@ export default async function handler(c: Context) {
 
 \u63A5\u7D9A\u5148\u306F **InfluxDB 3**\uFF08\`/api/v3/query_sql\` \u306E SQL \u5BFE\u5FDC\uFF09\u3068 **InfluxDB 2**\uFF08Flux \u306E\u307F\u3002\`*.cloud2.influxdata.com\` \u306E InfluxDB Cloud \u3092\u542B\u3080\uFF09\u306E\u3069\u3061\u3089\u306E\u53EF\u80FD\u6027\u3082\u3042\u308A\u307E\u3059\u3002\u5FC5\u305A\u6700\u521D\u306B\u30D7\u30ED\u30FC\u30D6\u3057\u3066\u304B\u3089\u3001\u5BFE\u5FDC\u3059\u308B\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044:
 
-1. \`influxdb_request\` \u3067 POST \`/api/v3/query_sql\`\u3001body \`{ "db": "<database>", "q": "SELECT 1" }\` \u3092\u547C\u3073\u51FA\u3059
+1. \`connector_influxdb_request\` \u3067 POST \`/api/v3/query_sql\`\u3001body \`{ "db": "<database>", "q": "SELECT 1" }\` \u3092\u547C\u3073\u51FA\u3059
 2. 200 + JSON \u884C \u2192 InfluxDB 3\u3002SQL \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3092\u4F7F\u7528\u3002
 3. 405 Method Not Allowed\u3001\u307E\u305F\u306F HTML \u672C\u6587\uFF08\u4F8B: \`<html>...405 Not Allowed...</html>\`\uFF09\u2192 InfluxDB 2\u3002\`/api/v2/query?org={org}\` \u304B\u3089 Flux \u3092\u4F7F\u7528\u3002\`org\` \u30D1\u30E9\u30E1\u30FC\u30BF\u5FC5\u9808\u3002\u672A\u8A2D\u5B9A\u306A\u3089 \`updateConnectionParameters\` \u3067\u30E6\u30FC\u30B6\u30FC\u306B\u8A2D\u5B9A\u3092\u4F9D\u983C\u3059\u308B\u3002
 
 ### \u30C4\u30FC\u30EB
 
-- \`influxdb_request\`: InfluxDB HTTP API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002SQL / InfluxQL / Flux \u30AF\u30A8\u30EA\u306E\u5B9F\u884C\u3001line protocol \u66F8\u304D\u8FBC\u307F\u3001bucket / database \u306E\u78BA\u8A8D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08\`Authorization: Token {token}\`\uFF09\u3068 instance URL \u306F\u81EA\u52D5\u3067\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002InfluxDB 3 \u3067\u306F SQL (\`POST /api/v3/query_sql\`) \u304C JSON \u884C\u3092\u8FD4\u3059\u305F\u3081\u6700\u3082\u6271\u3044\u3084\u3059\u3044\u3067\u3059\u3002InfluxDB 2 \u3067\u306F Flux (\`POST /api/v2/query?org={org}\`) \u3092\u4F7F\u7528\u3057\u3001\u30EC\u30B9\u30DD\u30F3\u30B9\u306F\u6CE8\u91C8\u4ED8\u304D CSV \u3067\u3059\u3002\u66F8\u304D\u8FBC\u307F\u306F \`POST /api/v3/write_lp?db={db}\` (v3) \u307E\u305F\u306F \`POST /api/v2/write?org={org}&bucket={bucket}\` (v2) \u306B line protocol \u3092\u9001\u308A\u307E\u3059\uFF08\`contentType\` \u306F \`text/plain; charset=utf-8\`\uFF09\u3002
+- \`connector_influxdb_request\`: InfluxDB HTTP API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002SQL / InfluxQL / Flux \u30AF\u30A8\u30EA\u306E\u5B9F\u884C\u3001line protocol \u66F8\u304D\u8FBC\u307F\u3001bucket / database \u306E\u78BA\u8A8D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08\`Authorization: Token {token}\`\uFF09\u3068 instance URL \u306F\u81EA\u52D5\u3067\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002InfluxDB 3 \u3067\u306F SQL (\`POST /api/v3/query_sql\`) \u304C JSON \u884C\u3092\u8FD4\u3059\u305F\u3081\u6700\u3082\u6271\u3044\u3084\u3059\u3044\u3067\u3059\u3002InfluxDB 2 \u3067\u306F Flux (\`POST /api/v2/query?org={org}\`) \u3092\u4F7F\u7528\u3057\u3001\u30EC\u30B9\u30DD\u30F3\u30B9\u306F\u6CE8\u91C8\u4ED8\u304D CSV \u3067\u3059\u3002\u66F8\u304D\u8FBC\u307F\u306F \`POST /api/v3/write_lp?db={db}\` (v3) \u307E\u305F\u306F \`POST /api/v2/write?org={org}&bucket={bucket}\` (v2) \u306B line protocol \u3092\u9001\u308A\u307E\u3059\uFF08\`contentType\` \u306F \`text/plain; charset=utf-8\`\uFF09\u3002
 
 ### Business Logic