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

package/dist/connectors/notion.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
@@ -245,6 +250,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
@@ -259,6 +273,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;
@@ -276,7 +298,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);
@@ -314,25 +338,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];
@@ -597,6 +621,50 @@ var notionSetupFlow = {
   }
 };
 
+// ../connectors/src/connectors/notion/introspect.ts
+var MAX_PAGES = 20;
+var PAGE_SIZE = 100;
+async function introspectNotion(ctx) {
+  const tables = [];
+  let cursor;
+  for (let page = 0; page < MAX_PAGES; page++) {
+    const body = {
+      filter: { property: "object", value: "database" },
+      page_size: PAGE_SIZE
+    };
+    if (cursor) body.start_cursor = cursor;
+    const res = await apiFetch(ctx.params, "/search", {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw new Error(`notion: search failed (${res.status})`);
+    }
+    const data = await res.json();
+    for (const db of data.results ?? []) {
+      const name = (db.title ?? []).map((t) => t.plain_text ?? "").join("").trim() || "Untitled";
+      const columns = Object.entries(
+        db.properties ?? {}
+      ).map(([propName, prop]) => {
+        const column = {
+          name: propName,
+          dataType: prop.type ?? "unknown",
+          nullable: true
+        };
+        if (prop.type === "title") column.isPrimaryKey = true;
+        if (prop.type === "relation" && prop.relation?.database_id) {
+          column.foreignKey = { table: prop.relation.database_id, column: "" };
+        }
+        return column;
+      });
+      tables.push({ schema: "", name, type: "table", columns });
+    }
+    if (!data.has_more || !data.next_cursor) break;
+    cursor = data.next_cursor;
+  }
+  return { tables };
+}
+
 // ../connectors/src/connectors/notion/tools/request.ts
 import { z } from "zod";
 var BASE_URL3 = "https://api.notion.com/v1";
@@ -832,6 +900,7 @@ export default async function handler(c: Context) {
 - 25\u4EF6\u4EE5\u4E0A\u306E\u30A2\u30A4\u30C6\u30E0\u3092\u6301\u3064\u30D7\u30ED\u30D1\u30C6\u30A3\uFF08people\u3001relation\u306A\u3069\uFF09\u306F\u5B8C\u5168\u306A\u30C7\u30FC\u30BF\u53D6\u5F97\u306B\u30D7\u30ED\u30D1\u30C6\u30A3\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u304C\u5FC5\u8981\u3067\u3059`
   },
   tools,
+  introspect: (ctx) => introspectNotion(ctx),
   setup: (params, ctx, config) => runSetupFlow(notionSetupFlow, params, ctx, config),
   async checkConnection(params, _config) {
     const apiKey = params[parameters.apiKey.slug];

package/dist/connectors/openai.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
@@ -105,6 +110,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
@@ -119,6 +133,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;
@@ -136,7 +158,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);
@@ -174,25 +198,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/oracle.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)
@@ -334,10 +339,16 @@ async function runOracleQuery(parsed, sql, options = {}) {
           outFormat: oracledb.OUT_FORMAT_OBJECT,
           // Bound by the connector's own row cap, but keep the driver from
           // streaming arbitrarily large result sets.
-          maxRows: 5e3
+          maxRows: 5e3,
+          // oracledb defaults to autoCommit=false, which silently rolls back
+          // DML when the connection closes.
+          autoCommit: true
         }
       );
-      return { rows: result.rows ?? [] };
+      return {
+        rows: result.rows ?? [],
+        rowsAffected: result.rowsAffected
+      };
     } finally {
       try {
         await connection2.close();
@@ -508,6 +519,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
@@ -522,6 +542,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;
@@ -539,7 +567,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);
@@ -577,25 +607,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];
@@ -604,6 +634,80 @@ var ConnectorPlugin = class _ConnectorPlugin {
   }
 };
 
+// ../connectors/src/survey-probe.ts
+function rowsOf(output) {
+  if (!output || typeof output !== "object") return [];
+  const o = output;
+  if (o.success === false) return [];
+  return Array.isArray(o.rows) ? o.rows : [];
+}
+function pickString(row, candidates) {
+  for (const key of candidates) {
+    const v = row[key] ?? row[key.toUpperCase()] ?? row[key.toLowerCase()];
+    if (typeof v === "string" && v.length > 0) return v;
+  }
+  return void 0;
+}
+var TABLE_NAME_FIELDS = [
+  "table_name",
+  "name",
+  "tableName",
+  "tab_name",
+  "Table",
+  "table"
+];
+function makeQuoteIdent(opts) {
+  if (opts.bracket) {
+    return (name) => `[${name.replaceAll("]", "]]")}]`;
+  }
+  const q = opts.quote ?? '"';
+  return (name) => `${q}${name.replaceAll(q, q + q)}${q}`;
+}
+function sampleSql(ref, limit) {
+  return `SELECT * FROM (SELECT * FROM ${ref}) AS _sq LIMIT ${limit}`;
+}
+function distinctTables(prior, max) {
+  const names = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const row of rowsOf(prior[0]?.output)) {
+    const name = pickString(row, TABLE_NAME_FIELDS);
+    if (!name || seen.has(name)) continue;
+    seen.add(name);
+    names.push(name);
+    if (names.length >= max) break;
+  }
+  return names;
+}
+function makeOracleSurveyProbes(opts) {
+  const queryTool = opts?.queryTool ?? "executeQuery";
+  const sampleLimit = opts?.sampleLimit ?? 5;
+  const maxSampleTables = opts?.maxSampleTables ?? 4;
+  const quoteIdent = makeQuoteIdent({ quote: '"' });
+  return (_connectionId, prior) => {
+    if (prior.length === 0) {
+      return [
+        {
+          tool: queryTool,
+          input: {
+            toolUseIntent: "Survey table/column metadata",
+            sql: "SELECT table_name, column_name, data_type FROM user_tab_columns ORDER BY table_name, column_id FETCH FIRST 1000 ROWS ONLY"
+          }
+        }
+      ];
+    }
+    if (prior.length === 1) {
+      return distinctTables(prior, maxSampleTables).map((name) => ({
+        tool: queryTool,
+        input: {
+          toolUseIntent: `Sample ${name}`,
+          sql: sampleSql(quoteIdent(name), sampleLimit)
+        }
+      }));
+    }
+    return [];
+  };
+}
+
 // ../connectors/src/setup-flow.ts
 async function runSetupFlow(flow, params, ctx, config) {
   const runtime = {
@@ -674,6 +778,58 @@ async function resolveSetupSelection(params) {
   return resolved.slice(0, limit);
 }
 
+// ../connectors/src/introspect-concurrency.ts
+async function mapWithConcurrency(items, limit, fn) {
+  const results = new Array(items.length);
+  let next = 0;
+  const workers = Array.from(
+    { length: Math.min(Math.max(limit, 1), items.length) },
+    async () => {
+      for (; ; ) {
+        const i = next++;
+        if (i >= items.length) return;
+        results[i] = await fn(items[i]);
+      }
+    }
+  );
+  await Promise.all(workers);
+  return results;
+}
+
+// ../connectors/src/introspect-profile.ts
+var DEFAULT_MAX_TABLES = 200;
+var DEFAULT_CONCURRENCY = 5;
+function dq(ident) {
+  return `"${ident.replace(/"/g, '""')}"`;
+}
+var quoteAnsi = (schema, name) => [...schema.split("."), name].map(dq).join(".");
+async function withRowCounts(ctx, schemaPromise, quoteRef, opts = {}) {
+  const schema = await schemaPromise;
+  if (!ctx.profile || !ctx.query) return schema;
+  return attachRowCounts(ctx.query, schema, quoteRef, opts);
+}
+async function attachRowCounts(run, schema, quoteRef, opts = {}) {
+  const targets = schema.tables.slice(0, opts.maxTables ?? DEFAULT_MAX_TABLES);
+  await mapWithConcurrency(
+    targets,
+    opts.concurrency ?? DEFAULT_CONCURRENCY,
+    async (table) => {
+      try {
+        const { rows } = await run(
+          `SELECT COUNT(*) AS row_count FROM ${quoteRef(table.schema, table.name)}`
+        );
+        const first = rows[0] ? Object.values(rows[0])[0] : void 0;
+        const rowCount = Number(first);
+        if (Number.isFinite(rowCount)) {
+          table.profile = { ...table.profile ?? {}, rowCount };
+        }
+      } catch {
+      }
+    }
+  );
+  return schema;
+}
+
 // ../connectors/src/auth-types.ts
 var AUTH_TYPES = {
   OAUTH: "oauth",
@@ -684,6 +840,63 @@ var AUTH_TYPES = {
   USER_PASSWORD: "user-password"
 };
 
+// ../connectors/src/introspect-information-schema.ts
+function pickCI(row, key) {
+  if (key in row) return String(row[key] ?? "");
+  const lower = key.toLowerCase();
+  for (const k of Object.keys(row)) {
+    if (k.toLowerCase() === lower) return String(row[k] ?? "");
+  }
+  return "";
+}
+function assembleIntrospectedSchema(input) {
+  const { colRows, pkRows = [], fkRows = [] } = input;
+  const pkSet = /* @__PURE__ */ new Set();
+  for (const r of pkRows) {
+    pkSet.add(
+      `${pickCI(r, "table_schema")}.${pickCI(r, "table_name")}.${pickCI(r, "column_name")}`
+    );
+  }
+  const fkMap = /* @__PURE__ */ new Map();
+  for (const r of fkRows) {
+    fkMap.set(
+      `${pickCI(r, "table_schema")}.${pickCI(r, "table_name")}.${pickCI(r, "column_name")}`,
+      {
+        schema: pickCI(r, "foreign_table_schema"),
+        table: pickCI(r, "foreign_table_name"),
+        column: pickCI(r, "foreign_column_name")
+      }
+    );
+  }
+  const tableMap = /* @__PURE__ */ new Map();
+  for (const r of colRows) {
+    const schema = pickCI(r, "table_schema");
+    const name = pickCI(r, "table_name");
+    const key = `${schema}.${name}`;
+    let table = tableMap.get(key);
+    if (!table) {
+      table = {
+        schema,
+        name,
+        type: pickCI(r, "table_type").toUpperCase() === "VIEW" ? "view" : "table",
+        columns: []
+      };
+      tableMap.set(key, table);
+    }
+    const colKey = `${schema}.${name}.${pickCI(r, "column_name")}`;
+    const column = {
+      name: pickCI(r, "column_name"),
+      dataType: pickCI(r, "data_type"),
+      nullable: pickCI(r, "is_nullable").toUpperCase() === "YES"
+    };
+    if (pkSet.has(colKey)) column.isPrimaryKey = true;
+    const fk = fkMap.get(colKey);
+    if (fk) column.foreignKey = fk;
+    table.columns.push(column);
+  }
+  return { tables: [...tableMap.values()] };
+}
+
 // ../connectors/src/lib/unwrap-sample-limit.ts
 var STRICT_WRAPPER_RE = /^\s*SELECT\s+\*\s+FROM\s+\(([\s\S]+)\)\s+AS\s+\w+\s+LIMIT\s+(\d+)\s*;?\s*$/i;
 var TRAILING_LIMIT_RE = /\s+LIMIT\s+(\d+)\s*;?\s*$/i;
@@ -904,6 +1117,58 @@ var oracleSetupFlow = {
   }
 };
 
+// ../connectors/src/connectors/oracle/introspect.ts
+var OWNER_NOT_IN = [...INTERNAL_OWNERS].map((o) => `'${o}'`).join(", ");
+function ownerFilter(ownerCol) {
+  return `${ownerCol} NOT IN (${OWNER_NOT_IN}) AND ${ownerCol} NOT LIKE 'APEX_%'`;
+}
+async function introspectOracle(run) {
+  const [{ rows: colRows }, { rows: pkRows }, { rows: fkRows }] = await Promise.all([
+    // 1) 全カラム（型 / nullable）+ テーブル種別（TABLE / VIEW）
+    run(
+      `SELECT c.owner AS table_schema, c.table_name AS table_name,
+                c.column_name AS column_name, c.data_type AS data_type,
+                CASE WHEN c.nullable = 'Y' THEN 'YES' ELSE 'NO' END AS is_nullable,
+                c.column_id AS ordinal_position,
+                CASE WHEN o.object_type = 'VIEW' THEN 'VIEW' ELSE 'BASE TABLE' END AS table_type
+           FROM all_tab_columns c
+           JOIN all_objects o
+             ON o.owner = c.owner AND o.object_name = c.table_name
+            AND o.object_type IN ('TABLE', 'VIEW')
+          WHERE ${ownerFilter("c.owner")}
+          ORDER BY c.owner, c.table_name, c.column_id`
+    ),
+    // 2) 主キー（CONSTRAINT_TYPE = 'P'）
+    run(
+      `SELECT ac.owner AS table_schema, ac.table_name AS table_name,
+                acc.column_name AS column_name
+           FROM all_constraints ac
+           JOIN all_cons_columns acc
+             ON acc.owner = ac.owner AND acc.constraint_name = ac.constraint_name
+          WHERE ac.constraint_type = 'P'
+            AND ${ownerFilter("ac.owner")}`
+    ),
+    // 3) 外部キー（CONSTRAINT_TYPE = 'R'）。参照元 → 参照先を position で突き合わせる。
+    run(
+      `SELECT ac.owner AS table_schema, ac.table_name AS table_name,
+                acc.column_name AS column_name,
+                rac.owner AS foreign_table_schema, rac.table_name AS foreign_table_name,
+                racc.column_name AS foreign_column_name
+           FROM all_constraints ac
+           JOIN all_cons_columns acc
+             ON acc.owner = ac.owner AND acc.constraint_name = ac.constraint_name
+           JOIN all_constraints rac
+             ON rac.owner = ac.r_owner AND rac.constraint_name = ac.r_constraint_name
+           JOIN all_cons_columns racc
+             ON racc.owner = rac.owner AND racc.constraint_name = rac.constraint_name
+            AND racc.position = acc.position
+          WHERE ac.constraint_type = 'R'
+            AND ${ownerFilter("ac.owner")}`
+    )
+  ]);
+  return assembleIntrospectedSchema({ colRows, pkRows, fkRows });
+}
+
 // ../connectors/src/connectors/oracle/tools/execute-query.ts
 import { z } from "zod";
 init_oracle_runner();
@@ -923,6 +1188,9 @@ var outputSchema = z.discriminatedUnion("success", [
   z.object({
     success: z.literal(true),
     rowCount: z.number(),
+    rowsAffected: z.number().optional().describe(
+      "Affected rows for INSERT/UPDATE/DELETE; undefined for SELECT"
+    ),
     truncated: z.boolean(),
     rows: z.array(z.record(z.string(), z.unknown()))
   }),
@@ -937,7 +1205,8 @@ var executeQueryTool = new ConnectorTool({
 Use for: schema exploration via \`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_TABLES\`, data sampling, and analytical queries.
 Oracle uses \`FETCH FIRST n ROWS ONLY\` (12c+) or \`ROWNUM\` for row limiting \u2014 there is no \`LIMIT\` keyword.
 Unquoted identifiers are stored upper-case (\`SELECT * FROM employees\` resolves to \`EMPLOYEES\`).
-Do NOT terminate statements with a semicolon; the driver rejects trailing terminators.`,
+Do NOT terminate statements with a semicolon; the driver rejects trailing terminators.
+For INSERT/UPDATE/DELETE, \`rowCount\` is 0 and \`rows\` is empty (rowCount counts returned rows, not affected rows) \u2014 this is normal, not a failure; check \`rowsAffected\` for the number of affected rows.`,
   inputSchema,
   outputSchema,
   async execute({ connectionId, sql }, connections) {
@@ -965,13 +1234,15 @@ Do NOT terminate statements with a semicolon; the driver rejects trailing termin
     }
     try {
       const cleanSql = sql.replace(/;\s*$/, "");
-      const { rows } = await runOracleQuery(parsed, cleanSql, {
+      const { rows, rowsAffected } = await runOracleQuery(parsed, cleanSql, {
         tunnelParams: connectionParamsToRecord(connection2)
       });
       const truncated = rows.length > MAX_ROWS;
       return {
         success: true,
         rowCount: Math.min(rows.length, MAX_ROWS),
+        // oracledb sets rowsAffected only for DML; undefined for SELECT.
+        rowsAffected,
         truncated,
         rows: rows.slice(0, MAX_ROWS)
       };
@@ -1037,6 +1308,9 @@ The business logic type for this connector is "sql".
 - \u884C\u6570\u5236\u9650\u306E\u4E92\u63DB\u6027: \u30D7\u30E9\u30C3\u30C8\u30D5\u30A9\u30FC\u30E0\u306E server-logic \u30B9\u30AD\u30FC\u30DE\u63A8\u8AD6\u306F\u3001\u30AF\u30A8\u30EA\u3092 \`SELECT * FROM (<inner>) AS _sq LIMIT N\` \u306E\u5F62\u3067\u30E9\u30C3\u30D7\u3057\u3066\u304F\u308B\u3053\u3068\u304C\u3042\u308A\u307E\u3059\u3002Oracle \u306B\u306F \`LIMIT\` \u30AD\u30FC\u30EF\u30FC\u30C9\u304C\u5B58\u5728\u3057\u306A\u3044\u305F\u3081\u3001\u30B3\u30CD\u30AF\u30BF\u306F \`query()\` \u5185\u3067\u3053\u306E\u30E9\u30C3\u30D1\u3092\u691C\u51FA\u3057\u3001\`<inner>\` \u3092\u305D\u306E\u307E\u307E\u5B9F\u884C\u3057\u3066 JS \u5074\u3067\u5148\u982D N \u884C\u306B\u5207\u308A\u8A70\u3081\u307E\u3059\u3002\u5229\u7528\u8005\u5074\u3067\u5BFE\u51E6\u3059\u308B\u5FC5\u8981\u306F\u3042\u308A\u307E\u305B\u3093\u304C\u3001\u81EA\u5206\u3067\u66F8\u304F SQL \u3067\u306F \`LIMIT\` \u3092\u4F7F\u308F\u305A \`FETCH FIRST N ROWS ONLY\` / \`OFFSET m ROWS FETCH NEXT N ROWS ONLY\` / \`ROWNUM\` \u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002`
   },
   tools,
+  // 決定論的な立ち上げ survey（ルールベース prewarm）。Oracle は USER_TAB_COLUMNS でメタ取得。
+  surveyProbes: makeOracleSurveyProbes(),
+  introspect: (ctx) => withRowCounts(ctx, introspectOracle(ctx.query), quoteAnsi),
   setup: (params, ctx, config) => runSetupFlow(oracleSetupFlow, params, ctx, config),
   async checkConnection(params, _config) {
     return checkOracleConnection(