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

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);
@@ -547,7 +577,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(
@@ -557,7 +587,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) {
@@ -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;
@@ -706,12 +919,12 @@ init_oracle_runner();
 // ../connectors/src/connectors/oracle/setup.ts
 var oracleOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Use oracle_executeQuery to confirm the version: \`SELECT BANNER FROM V$VERSION\`
+    en: `1. Use connector_oracle_executeQuery to confirm the version: \`SELECT BANNER FROM V$VERSION\`
 2. Identify the current schema (Oracle treats users as schemas): \`SELECT USER FROM DUAL\`
 3. List user tables: \`SELECT TABLE_NAME FROM USER_TABLES\`. To explore other schemas the connection has access to, use \`ALL_TABLES\` filtered by \`OWNER\`.
 4. For key tables, fetch column info: \`SELECT COLUMN_NAME, DATA_TYPE FROM USER_TAB_COLUMNS WHERE TABLE_NAME = UPPER('xxx')\` (Oracle stores unquoted identifiers as upper-case).
 5. Sample up to 3 tables. Oracle has no \`LIMIT\` keyword: use \`FETCH FIRST n ROWS ONLY\` or \`ROWNUM\`: \`SELECT * FROM <table> FETCH FIRST 5 ROWS ONLY\``,
-    ja: `1. oracle_executeQuery \u3067\u30D0\u30FC\u30B8\u30E7\u30F3\u3092\u78BA\u8A8D: \`SELECT BANNER FROM V$VERSION\`
+    ja: `1. connector_oracle_executeQuery \u3067\u30D0\u30FC\u30B8\u30E7\u30F3\u3092\u78BA\u8A8D: \`SELECT BANNER FROM V$VERSION\`
 2. \u73FE\u5728\u306E\u30B9\u30AD\u30FC\u30DE\uFF08Oracle\u3067\u306F\u30E6\u30FC\u30B6\u30FC\uFF1D\u30B9\u30AD\u30FC\u30DE\uFF09\u3092\u78BA\u8A8D: \`SELECT USER FROM DUAL\`
 3. \u30E6\u30FC\u30B6\u30FC\u30C6\u30FC\u30D6\u30EB\u4E00\u89A7\u3092\u53D6\u5F97: \`SELECT TABLE_NAME FROM USER_TABLES\`\u3002\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u4ED6\u30B9\u30AD\u30FC\u30DE\u3092\u53C2\u7167\u3059\u308B\u5834\u5408\u306F \`ALL_TABLES\` \u3092 \`OWNER\` \u3067\u30D5\u30A3\u30EB\u30BF\u30EA\u30F3\u30B0\u3002
 4. \u4E3B\u8981\u30C6\u30FC\u30D6\u30EB\u306E\u30AB\u30E9\u30E0\u60C5\u5831\u3092\u53D6\u5F97: \`SELECT COLUMN_NAME, DATA_TYPE FROM USER_TAB_COLUMNS WHERE TABLE_NAME = UPPER('xxx')\`\uFF08Oracle \u306F\u30AF\u30A9\u30FC\u30C8\u306A\u3057\u8B58\u5225\u5B50\u3092\u5927\u6587\u5B57\u3067\u4FDD\u5B58\uFF09\u3002
@@ -840,6 +1053,20 @@ var oracleSetupFlow = {
       fetchAll: () => fetchTableAndViewNames(rt.params, owner),
       limit: ORACLE_SETUP_MAX_TABLES
     });
+    let rowCounts = /* @__PURE__ */ new Map();
+    try {
+      const countRows = await runOracleSetupQuery(
+        rt.params,
+        `SELECT TABLE_NAME, NUM_ROWS FROM ALL_TABLES WHERE OWNER = ${quoteLiteral(owner)}`
+      );
+      rowCounts = new Map(
+        countRows.filter((r) => r["NUM_ROWS"] != null).map((r) => [
+          String(r["TABLE_NAME"] ?? ""),
+          Number(r["NUM_ROWS"])
+        ])
+      );
+    } catch {
+    }
     const typeRows = targetTables.length > 0 ? await runOracleSetupQuery(
       rt.params,
       `SELECT OBJECT_NAME, OBJECT_TYPE FROM ALL_OBJECTS
@@ -869,7 +1096,9 @@ var oracleSetupFlow = {
            AND TABLE_NAME = ${quoteLiteral(table)}
          ORDER BY COLUMN_ID`
       );
-      sections.push(`#### ${heading}: ${table}`, "");
+      const rowCount = rowCounts.get(table);
+      const rowCountSuffix = typeof rowCount === "number" ? ` (~${rowCount.toLocaleString()} rows)` : "";
+      sections.push(`#### ${heading}: ${table}${rowCountSuffix}`, "");
       sections.push("| Column | Type | Nullable | Default |");
       sections.push("|--------|------|----------|---------|");
       for (const c of cols) {
@@ -888,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();
@@ -907,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()))
   }),
@@ -921,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) {
@@ -949,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)
       };
@@ -983,7 +1270,7 @@ var oracleConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`oracle_executeQuery\`: Executes a SQL query against an Oracle Database and returns rows. Use it for schema exploration via \`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_TABLES\` and for sampling data. See the SQL Reference below for Oracle-specific syntax.
+- \`connector_oracle_executeQuery\`: Executes a SQL query against an Oracle Database and returns rows. Use it for schema exploration via \`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_TABLES\` and for sampling data. See the SQL Reference below for Oracle-specific syntax.
 
 ### Business Logic
 
@@ -1002,7 +1289,7 @@ The business logic type for this connector is "sql".
 - Row-limit compatibility: the platform's server-logic schema inference may wrap your query as \`SELECT * FROM (<inner>) AS _sq LIMIT N\`. Oracle has no \`LIMIT\` keyword, so the connector detects this exact wrapper at \`query()\` time, executes \`<inner>\` directly, and slices the first N rows in JS. You do not need to handle this \u2014 but do not author your own \`LIMIT\` clauses; use \`FETCH FIRST N ROWS ONLY\`, \`OFFSET m ROWS FETCH NEXT N ROWS ONLY\`, or \`ROWNUM\` filters.`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`oracle_executeQuery\`: Oracle Database \u306B\u5BFE\u3057\u3066 SQL \u3092\u5B9F\u884C\u3057\u3001\u884C\u30C7\u30FC\u30BF\u3092\u8FD4\u3057\u307E\u3059\u3002\`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_TABLES\` \u3092\u4F7F\u3063\u305F\u30B9\u30AD\u30FC\u30DE\u63A2\u7D22\u3084\u30C7\u30FC\u30BF\u306E\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u306B\u4F7F\u3044\u307E\u3059\u3002Oracle \u56FA\u6709\u306E\u69CB\u6587\u306F\u4E0B\u90E8\u306E\u300CSQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \`connector_oracle_executeQuery\`: Oracle Database \u306B\u5BFE\u3057\u3066 SQL \u3092\u5B9F\u884C\u3057\u3001\u884C\u30C7\u30FC\u30BF\u3092\u8FD4\u3057\u307E\u3059\u3002\`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_TABLES\` \u3092\u4F7F\u3063\u305F\u30B9\u30AD\u30FC\u30DE\u63A2\u7D22\u3084\u30C7\u30FC\u30BF\u306E\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u306B\u4F7F\u3044\u307E\u3059\u3002Oracle \u56FA\u6709\u306E\u69CB\u6587\u306F\u4E0B\u90E8\u306E\u300CSQL \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 ### Business Logic
 
@@ -1021,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(