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

package/dist/connectors/google-docs.js

@@ -121,6 +121,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
@@ -135,6 +144,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;
@@ -152,7 +169,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);
@@ -160,7 +179,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(
@@ -170,7 +189,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) {
@@ -190,25 +209,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];
@@ -310,10 +329,10 @@ function normalizeRequestPath(path2, basePathSegment) {
 // ../connectors/src/connectors/google-docs/setup.ts
 var googleDocsOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Create a new document with google-docs-oauth_request (POST with body { title: "..." }) or use an existing document ID.
-2. Call google-docs-oauth_request with GET /{documentId} to fetch the document's content and metadata.`,
-    ja: `1. google-docs-oauth_request \u3092 POST\uFF08Body: { title: "..." }\uFF09\u3067\u547C\u3073\u51FA\u3057\u3066\u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u4F5C\u6210\u3059\u308B\u304B\u3001\u65E2\u5B58\u306E\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8ID\u3092\u5229\u7528\u3057\u307E\u3059\u3002
-2. google-docs-oauth_request \u3067 GET /{documentId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u5185\u5BB9\u3068\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002`
+    en: `1. Create a new document with connector_google-docs-oauth_request (POST with body { title: "..." }) or use an existing document ID.
+2. Call connector_google-docs-oauth_request with GET /{documentId} to fetch the document's content and metadata.`,
+    ja: `1. connector_google-docs-oauth_request \u3092 POST\uFF08Body: { title: "..." }\uFF09\u3067\u547C\u3073\u51FA\u3057\u3066\u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u4F5C\u6210\u3059\u308B\u304B\u3001\u65E2\u5B58\u306E\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8ID\u3092\u5229\u7528\u3057\u307E\u3059\u3002
+2. connector_google-docs-oauth_request \u3067 GET /{documentId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u5185\u5BB9\u3068\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002`
   }
 });
 
@@ -566,9 +585,9 @@ var googleDocsConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools (setup-time only)
 
-- \`google-docs-oauth_request\`: Call the Google Docs API directly during setup / data overview. Supports read and write operations. Use it to get document content, create new documents, and modify document content via batchUpdate. Authentication is configured automatically via OAuth.
+- \`connector_google-docs-oauth_request\`: Call the Google Docs API directly during setup / data overview. Supports read and write operations. Use it to get document content, create new documents, and modify document content via batchUpdate. Authentication is configured automatically via OAuth.
 
-> **Important**: The \`google-docs-oauth_request\` tool is only available at setup time. Inside server-logic handlers, use the SDK (\`connection(id).createDocument\`, etc.) \u2014 the SDK's fetch is already wired through the OAuth proxy. **Do NOT** hand-roll HTTP calls to \`_sqcore/connections/*/request\` from a handler.
+> **Important**: The \`connector_google-docs-oauth_request\` tool is only available at setup time. Inside server-logic handlers, use the SDK (\`connection(id).createDocument\`, etc.) \u2014 the SDK's fetch is already wired through the OAuth proxy. **Do NOT** hand-roll HTTP calls to \`_sqcore/connections/*/request\` from a handler.
 
 ### Google Docs API Reference
 
@@ -635,9 +654,9 @@ await docs.batchUpdate(documentId, [
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB\uFF08\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\uFF09
 
-- \`google-docs-oauth_request\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3084\u30C7\u30FC\u30BF\u6982\u8981\u628A\u63E1\u6642\u306B Google Docs API \u3092\u76F4\u63A5\u53E9\u304F\u30C4\u30FC\u30EB\u3067\u3059\u3002\u8AAD\u307F\u53D6\u308A\u3068\u66F8\u304D\u8FBC\u307F\u306E\u4E21\u65B9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u5185\u5BB9\u306E\u53D6\u5F97\u3001\u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u4F5C\u6210\u3001batchUpdate \u306B\u3088\u308B\u5185\u5BB9\u5909\u66F4\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-docs-oauth_request\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3084\u30C7\u30FC\u30BF\u6982\u8981\u628A\u63E1\u6642\u306B Google Docs API \u3092\u76F4\u63A5\u53E9\u304F\u30C4\u30FC\u30EB\u3067\u3059\u3002\u8AAD\u307F\u53D6\u308A\u3068\u66F8\u304D\u8FBC\u307F\u306E\u4E21\u65B9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u5185\u5BB9\u306E\u53D6\u5F97\u3001\u65B0\u3057\u3044\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u4F5C\u6210\u3001batchUpdate \u306B\u3088\u308B\u5185\u5BB9\u5909\u66F4\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
 
-> **\u91CD\u8981**: \`google-docs-oauth_request\` \u306F\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\u5229\u7528\u53EF\u80FD\u3067\u3059\u3002\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u306E\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u5FC5\u305A SDK\uFF08\`connection(id).createDocument\` \u306A\u3069\uFF09\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002SDK \u306E fetch \u306F OAuth \u30D7\u30ED\u30AD\u30B7\u7D4C\u7531\u3067\u65E2\u306B\u914D\u7DDA\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u304B\u3089 \`_sqcore/connections/*/request\` \u3092\u624B\u66F8\u304D\u3067\u547C\u3073\u51FA\u3055\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+> **\u91CD\u8981**: \`connector_google-docs-oauth_request\` \u306F\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\u5229\u7528\u53EF\u80FD\u3067\u3059\u3002\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u306E\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u5FC5\u305A SDK\uFF08\`connection(id).createDocument\` \u306A\u3069\uFF09\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002SDK \u306E fetch \u306F OAuth \u30D7\u30ED\u30AD\u30B7\u7D4C\u7531\u3067\u65E2\u306B\u914D\u7DDA\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u304B\u3089 \`_sqcore/connections/*/request\` \u3092\u624B\u66F8\u304D\u3067\u547C\u3073\u51FA\u3055\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
 
 ### Google Docs API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 

package/dist/connectors/google-drive.js

@@ -210,6 +210,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
@@ -224,6 +233,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;
@@ -241,7 +258,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);
@@ -249,7 +268,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(
@@ -259,7 +278,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) {
@@ -279,25 +298,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];
@@ -399,10 +418,10 @@ function normalizeRequestPath(path2, basePathSegment) {
 // ../connectors/src/connectors/google-drive/setup.ts
 var googleDriveOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Call google-drive-oauth_request with GET /files?pageSize=20&fields=files(id,name,mimeType,modifiedTime)&orderBy=modifiedTime desc to list recent files
-2. Call google-drive-oauth_request with GET /about?fields=user,storageQuota to get account info and storage usage`,
-    ja: `1. google-drive-oauth_request \u3067 GET /files?pageSize=20&fields=files(id,name,mimeType,modifiedTime)&orderBy=modifiedTime desc \u3092\u547C\u3073\u51FA\u3057\u3001\u6700\u8FD1\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u4E00\u89A7\u8868\u793A
-2. google-drive-oauth_request \u3067 GET /about?fields=user,storageQuota \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AB\u30A6\u30F3\u30C8\u60C5\u5831\u3068\u30B9\u30C8\u30EC\u30FC\u30B8\u4F7F\u7528\u91CF\u3092\u53D6\u5F97`
+    en: `1. Call connector_google-drive-oauth_request with GET /files?pageSize=20&fields=files(id,name,mimeType,modifiedTime)&orderBy=modifiedTime desc to list recent files
+2. Call connector_google-drive-oauth_request with GET /about?fields=user,storageQuota to get account info and storage usage`,
+    ja: `1. connector_google-drive-oauth_request \u3067 GET /files?pageSize=20&fields=files(id,name,mimeType,modifiedTime)&orderBy=modifiedTime desc \u3092\u547C\u3073\u51FA\u3057\u3001\u6700\u8FD1\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u4E00\u89A7\u8868\u793A
+2. connector_google-drive-oauth_request \u3067 GET /about?fields=user,storageQuota \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AB\u30A6\u30F3\u30C8\u60C5\u5831\u3068\u30B9\u30C8\u30EC\u30FC\u30B8\u4F7F\u7528\u91CF\u3092\u53D6\u5F97`
   }
 });
 
@@ -543,6 +562,28 @@ var googleDriveSetupFlow = {
       );
     }
     sections.push("");
+    try {
+      const counts = /* @__PURE__ */ new Map();
+      for (const f of allFiles) {
+        const key = f.mimeType === FOLDER_MIME ? "folder" : f.mimeType ?? "(unknown)";
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+      }
+      const top = Array.from(counts.entries()).sort((a, b) => b[1] - a[1]).slice(0, 10);
+      if (top.length > 0) {
+        sections.push(
+          rt.language === "ja" ? "### \u30D5\u30A1\u30A4\u30EB\u7A2E\u5225\u306E\u5185\u8A33 (\u4E0A\u4F4D10\u4EF6)" : "### File type breakdown (top 10)",
+          ""
+        );
+        sections.push("| Mime Type | Count |");
+        sections.push("|-----------|-------|");
+        for (const [mime, count] of top) {
+          const safe = mime.replace(/\|/g, "\\|");
+          sections.push(`| ${safe} | ${count} |`);
+        }
+        sections.push("");
+      }
+    } catch {
+    }
     return sections.join("\n");
   }
 };
@@ -694,9 +735,9 @@ var googleDriveConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools (setup-time only)
 
-- \`google-drive-oauth_request\`: Send authenticated requests to the Google Drive API v3 during setup / data overview. Supports GET, POST, and PATCH methods. Authentication is configured automatically via OAuth.
+- \`connector_google-drive-oauth_request\`: Send authenticated requests to the Google Drive API v3 during setup / data overview. Supports GET, POST, and PATCH methods. Authentication is configured automatically via OAuth.
 
-> **Important**: The \`google-drive-oauth_request\` tool is only available at setup time. Inside server-logic handlers, use the SDK (\`connection(id).listFiles\`, etc.) \u2014 the SDK's fetch is already wired through the OAuth proxy. **Do NOT** hand-roll HTTP calls to \`_sqcore/connections/*/request\` from a handler.
+> **Important**: The \`connector_google-drive-oauth_request\` tool is only available at setup time. Inside server-logic handlers, use the SDK (\`connection(id).listFiles\`, etc.) \u2014 the SDK's fetch is already wired through the OAuth proxy. **Do NOT** hand-roll HTTP calls to \`_sqcore/connections/*/request\` from a handler.
 
 ### Google Drive API Reference
 
@@ -830,9 +871,9 @@ await drive.updateFile("fileId123", {}, "newFolderId", "oldFolderId");
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB\uFF08\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\uFF09
 
-- \`google-drive-oauth_request\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3084\u30C7\u30FC\u30BF\u6982\u8981\u628A\u63E1\u6642\u306B Google Drive API v3 \u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002GET, POST, PATCH \u30E1\u30BD\u30C3\u30C9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-drive-oauth_request\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3084\u30C7\u30FC\u30BF\u6982\u8981\u628A\u63E1\u6642\u306B Google Drive API v3 \u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002GET, POST, PATCH \u30E1\u30BD\u30C3\u30C9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
 
-> **\u91CD\u8981**: \`google-drive-oauth_request\` \u306F\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\u5229\u7528\u53EF\u80FD\u3067\u3059\u3002\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u306E\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u5FC5\u305A SDK\uFF08\`connection(id).listFiles\` \u306A\u3069\uFF09\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002SDK \u306E fetch \u306F OAuth \u30D7\u30ED\u30AD\u30B7\u7D4C\u7531\u3067\u65E2\u306B\u914D\u7DDA\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u304B\u3089 \`_sqcore/connections/*/request\` \u3092\u624B\u66F8\u304D\u3067\u547C\u3073\u51FA\u3055\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+> **\u91CD\u8981**: \`connector_google-drive-oauth_request\` \u306F\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\u5229\u7528\u53EF\u80FD\u3067\u3059\u3002\u30B5\u30FC\u30D0\u30FC\u30ED\u30B8\u30C3\u30AF\u306E\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u5FC5\u305A SDK\uFF08\`connection(id).listFiles\` \u306A\u3069\uFF09\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002SDK \u306E fetch \u306F OAuth \u30D7\u30ED\u30AD\u30B7\u7D4C\u7531\u3067\u65E2\u306B\u914D\u7DDA\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u304B\u3089 \`_sqcore/connections/*/request\` \u3092\u624B\u66F8\u304D\u3067\u547C\u3073\u51FA\u3055\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
 
 ### Google Drive API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 

package/dist/connectors/google-search-console-oauth.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
@@ -217,6 +222,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
@@ -231,6 +245,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;
@@ -248,7 +270,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);
@@ -256,7 +280,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(
@@ -266,7 +290,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) {
@@ -286,25 +310,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];
@@ -551,10 +575,10 @@ var googleSearchConsoleOauthOnboarding = 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 google-search-console-oauth_request with GET /sites/{siteUrl} to fetch metadata for the configured site
-2. Call google-search-console-oauth_request with POST /sites/{siteUrl}/searchAnalytics/query and a small body \u2014 startDate/endDate covering the last 7 days, dimensions ["date"], rowLimit 7 \u2014 to verify that performance data is available`,
-    ja: `1. google-search-console-oauth_request \u3067 GET /sites/{siteUrl} \u3092\u547C\u3073\u51FA\u3057\u3001\u8A2D\u5B9A\u3055\u308C\u305F\u30B5\u30A4\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97
-2. google-search-console-oauth_request \u3067 POST /sites/{siteUrl}/searchAnalytics/query \u3092\u76F4\u8FD17\u65E5\u9593\u306E startDate/endDate\u3001dimensions ["date"]\u3001rowLimit 7 \u3067\u547C\u3073\u51FA\u3057\u3001\u30D1\u30D5\u30A9\u30FC\u30DE\u30F3\u30B9\u30C7\u30FC\u30BF\u306E\u53EF\u7528\u6027\u3092\u78BA\u8A8D`
+    en: `1. Call connector_google-search-console-oauth_request with GET /sites/{siteUrl} to fetch metadata for the configured site
+2. Call connector_google-search-console-oauth_request with POST /sites/{siteUrl}/searchAnalytics/query and a small body \u2014 startDate/endDate covering the last 7 days, dimensions ["date"], rowLimit 7 \u2014 to verify that performance data is available`,
+    ja: `1. connector_google-search-console-oauth_request \u3067 GET /sites/{siteUrl} \u3092\u547C\u3073\u51FA\u3057\u3001\u8A2D\u5B9A\u3055\u308C\u305F\u30B5\u30A4\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97
+2. connector_google-search-console-oauth_request \u3067 POST /sites/{siteUrl}/searchAnalytics/query \u3092\u76F4\u8FD17\u65E5\u9593\u306E startDate/endDate\u3001dimensions ["date"]\u3001rowLimit 7 \u3067\u547C\u3073\u51FA\u3057\u3001\u30D1\u30D5\u30A9\u30FC\u30DE\u30F3\u30B9\u30C7\u30FC\u30BF\u306E\u53EF\u7528\u6027\u3092\u78BA\u8A8D`
   }
 });
 
@@ -577,6 +601,33 @@ function isVerified(site) {
   const level = site.permissionLevel ?? "";
   return level !== "" && level !== "siteUnverifiedUser";
 }
+function formatDate(daysAgo) {
+  const d = /* @__PURE__ */ new Date();
+  d.setDate(d.getDate() - daysAgo);
+  return d.toISOString().slice(0, 10);
+}
+async function querySearchAnalytics(proxyFetch, siteUrl, dimensions, rowLimit) {
+  try {
+    const res = await proxyFetch(
+      `${SITES_URL}/${encodeURIComponent(siteUrl)}/searchAnalytics/query`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          startDate: formatDate(28),
+          endDate: formatDate(1),
+          dimensions,
+          rowLimit
+        })
+      }
+    );
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.rows ?? [];
+  } catch {
+    return [];
+  }
+}
 var googleSearchConsoleOauthSetupFlow = {
   initialState: () => ({}),
   steps: [
@@ -615,7 +666,6 @@ var googleSearchConsoleOauthSetupFlow = {
     }
     const allSites = await listSites(rt.config.proxyFetch);
     const verified = allSites.filter(isVerified);
-    const siteByUrl = new Map(verified.map((s) => [s.siteUrl ?? "", s]));
     const targetSiteUrls = await resolveSetupSelection({
       selected: state.sites,
       allSentinel: ALL_SITES,
@@ -627,15 +677,98 @@ var googleSearchConsoleOauthSetupFlow = {
       sections.push("_No sites selected._", "");
       return sections.join("\n");
     }
-    sections.push("| Site URL | Permission Level |");
-    sections.push("|----------|------------------|");
     for (const siteUrl of targetSiteUrls) {
-      const site = siteByUrl.get(siteUrl);
-      const permission = site?.permissionLevel ?? "-";
       const safeSiteUrl = siteUrl.replace(/\|/g, "\\|");
-      sections.push(`| ${safeSiteUrl} | ${permission} |`);
+      sections.push(`### Site: ${safeSiteUrl}`, "");
+      const topQueries = await querySearchAnalytics(
+        rt.config.proxyFetch,
+        siteUrl,
+        ["query"],
+        10
+      );
+      if (topQueries.length > 0) {
+        sections.push("#### Top Search Queries (last 28 days)", "");
+        sections.push("| Query | Clicks | Impressions | CTR | Avg Position |");
+        sections.push("|-------|--------|-------------|-----|-------------|");
+        for (const row of topQueries) {
+          const q = (row.keys?.[0] ?? "").replace(/\|/g, "\\|");
+          const clicks = row.clicks ?? 0;
+          const impressions = row.impressions ?? 0;
+          const ctr = ((row.ctr ?? 0) * 100).toFixed(1);
+          const pos = (row.position ?? 0).toFixed(1);
+          sections.push(
+            `| ${q} | ${clicks} | ${impressions} | ${ctr}% | ${pos} |`
+          );
+        }
+        sections.push("");
+      }
+      const topPages = await querySearchAnalytics(
+        rt.config.proxyFetch,
+        siteUrl,
+        ["page"],
+        10
+      );
+      if (topPages.length > 0) {
+        sections.push("#### Top Pages (last 28 days)", "");
+        sections.push("| Page | Clicks | Impressions | CTR | Avg Position |");
+        sections.push("|------|--------|-------------|-----|-------------|");
+        for (const row of topPages) {
+          const pg = (row.keys?.[0] ?? "").replace(/\|/g, "\\|");
+          const clicks = row.clicks ?? 0;
+          const impressions = row.impressions ?? 0;
+          const ctr = ((row.ctr ?? 0) * 100).toFixed(1);
+          const pos = (row.position ?? 0).toFixed(1);
+          sections.push(
+            `| ${pg} | ${clicks} | ${impressions} | ${ctr}% | ${pos} |`
+          );
+        }
+        sections.push("");
+      }
+      const deviceRows = await querySearchAnalytics(
+        rt.config.proxyFetch,
+        siteUrl,
+        ["device"],
+        5
+      );
+      if (deviceRows.length > 0) {
+        sections.push("#### Device Breakdown (last 28 days)", "");
+        sections.push("| Device | Clicks | Impressions | CTR | Avg Position |");
+        sections.push("|--------|--------|-------------|-----|-------------|");
+        for (const row of deviceRows) {
+          const dev = row.keys?.[0] ?? "";
+          const clicks = row.clicks ?? 0;
+          const impressions = row.impressions ?? 0;
+          const ctr = ((row.ctr ?? 0) * 100).toFixed(1);
+          const pos = (row.position ?? 0).toFixed(1);
+          sections.push(
+            `| ${dev} | ${clicks} | ${impressions} | ${ctr}% | ${pos} |`
+          );
+        }
+        sections.push("");
+      }
+      const countryRows = await querySearchAnalytics(
+        rt.config.proxyFetch,
+        siteUrl,
+        ["country"],
+        10
+      );
+      if (countryRows.length > 0) {
+        sections.push("#### Top Countries (last 28 days)", "");
+        sections.push("| Country | Clicks | Impressions | CTR | Avg Position |");
+        sections.push("|---------|--------|-------------|-----|-------------|");
+        for (const row of countryRows) {
+          const c = row.keys?.[0] ?? "";
+          const clicks = row.clicks ?? 0;
+          const impressions = row.impressions ?? 0;
+          const ctr = ((row.ctr ?? 0) * 100).toFixed(1);
+          const pos = (row.position ?? 0).toFixed(1);
+          sections.push(
+            `| ${c} | ${clicks} | ${impressions} | ${ctr}% | ${pos} |`
+          );
+        }
+        sections.push("");
+      }
     }
-    sections.push("");
     return sections.join("\n");
   }
 };
@@ -798,8 +931,8 @@ var googleSearchConsoleOauthConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`google-search-console-oauth_request\`: Send authenticated requests to the Google Search Console API (Webmasters v3). Use it for searchAnalytics queries, sitemap inspection, and site metadata. The {siteUrl} placeholder in paths is automatically replaced and URL-encoded. Authentication is configured automatically via OAuth.
-- \`google-search-console-oauth_listSites\`: List accessible Search Console sites. Use during setup to discover available properties.
+- \`connector_google-search-console-oauth_request\`: Send authenticated requests to the Google Search Console API (Webmasters v3). Use it for searchAnalytics queries, sitemap inspection, and site metadata. The {siteUrl} placeholder in paths is automatically replaced and URL-encoded. Authentication is configured automatically via OAuth.
+- \`connector_google-search-console-oauth_listSites\`: List accessible Search Console sites. Use during setup to discover available properties.
 
 ### Search Console API Reference
 
@@ -884,8 +1017,8 @@ sitemaps.forEach(s => console.log(s.path, s.lastSubmitted));
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`google-search-console-oauth_request\`: Google Search Console API (Webmasters v3) \u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002searchAnalytics \u30AF\u30A8\u30EA\u3001\u30B5\u30A4\u30C8\u30DE\u30C3\u30D7\u78BA\u8A8D\u3001\u30B5\u30A4\u30C8\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{siteUrl}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306BURL\u30A8\u30F3\u30B3\u30FC\u30C9\u3055\u308C\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
-- \`google-search-console-oauth_listSites\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306ASearch Console\u30B5\u30A4\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
+- \`connector_google-search-console-oauth_request\`: Google Search Console API (Webmasters v3) \u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002searchAnalytics \u30AF\u30A8\u30EA\u3001\u30B5\u30A4\u30C8\u30DE\u30C3\u30D7\u78BA\u8A8D\u3001\u30B5\u30A4\u30C8\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{siteUrl}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306BURL\u30A8\u30F3\u30B3\u30FC\u30C9\u3055\u308C\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-search-console-oauth_listSites\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306ASearch Console\u30B5\u30A4\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 
 ### Search Console API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9