@squadbase/vite-server 0.1.17 → 0.1.18

package/dist/connectors/google-sheets.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
@@ -62,6 +67,12 @@ function createClient(_params, fetchFn = fetch) {
     return `${SHEETS_BASE_URL}${path2 === "" || path2.startsWith("/") ? "" : "/"}${path2}`;
   }
   async function request(path2, init) {
+    const method = (init?.method ?? "GET").toUpperCase();
+    if (method !== "GET") {
+      throw new Error(
+        "google-sheets: this connector is read-only; only GET requests are supported"
+      );
+    }
     return fetchFn(buildUrl(path2), init);
   }
   async function asJson(response, operation) {
@@ -89,51 +100,11 @@ function createClient(_params, fetchFn = fetch) {
     const url = `${SHEETS_BASE_URL}/${spreadsheetId}/values:batchGet?${searchParams.toString()}`;
     return asJson(await fetchFn(url), "batchGetValues");
   }
-  async function updateValues(spreadsheetId, range, values, valueInputOption = "USER_ENTERED") {
-    const url = `${SHEETS_BASE_URL}/${spreadsheetId}/values/${encodeURIComponent(range)}?valueInputOption=${valueInputOption}`;
-    const response = await fetchFn(url, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ range, majorDimension: "ROWS", values })
-    });
-    return asJson(response, "updateValues");
-  }
-  async function appendValues(spreadsheetId, range, values, valueInputOption = "USER_ENTERED") {
-    const url = `${SHEETS_BASE_URL}/${spreadsheetId}/values/${encodeURIComponent(range)}:append?valueInputOption=${valueInputOption}`;
-    const response = await fetchFn(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ range, majorDimension: "ROWS", values })
-    });
-    return asJson(response, "appendValues");
-  }
-  async function clearValues(spreadsheetId, range) {
-    const url = `${SHEETS_BASE_URL}/${spreadsheetId}/values/${encodeURIComponent(range)}:clear`;
-    const response = await fetchFn(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({})
-    });
-    return asJson(response, "clearValues");
-  }
-  async function batchUpdate(spreadsheetId, requests) {
-    const url = `${SHEETS_BASE_URL}/${spreadsheetId}:batchUpdate`;
-    const response = await fetchFn(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ requests })
-    });
-    return asJson(response, "batchUpdate");
-  }
   return {
     request,
     getSpreadsheet,
     getValues,
-    batchGetValues,
-    updateValues,
-    appendValues,
-    clearValues,
-    batchUpdate
+    batchGetValues
   };
 }
 
@@ -204,6 +175,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
@@ -218,6 +198,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;
@@ -235,7 +223,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);
@@ -273,25 +263,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];
@@ -364,11 +354,6 @@ async function runSetupFlow(flow, params, ctx, config) {
     }
   };
 }
-async function resolveSetupSelection(params) {
-  const { selected, allSentinel, fetchAll, limit } = params;
-  const resolved = selected.includes(allSentinel) ? await fetchAll() : selected.filter((v) => v !== allSentinel);
-  return resolved.slice(0, limit);
-}
 
 // ../connectors/src/auth-types.ts
 var AUTH_TYPES = {
@@ -432,16 +417,13 @@ var inputSchema = z.object({
     "Brief description of what you intend to accomplish with this tool call"
   ),
   connectionId: z.string().describe("ID of the Google Sheets connection to use"),
-  method: z.enum(["GET", "POST", "PUT"]).describe(
-    "HTTP method. GET for reads, PUT for values.update, POST for values.append / values:batchUpdate / values:batchGet / values:clear / values:batchClear."
+  method: z.enum(["GET"]).describe(
+    "HTTP method. Read-only: only GET is supported (e.g., spreadsheets.get, values.get, values:batchGet)."
   ),
   path: z.string().describe(
     "API path appended to https://sheets.googleapis.com/v4/spreadsheets. The caller must provide the target spreadsheetId explicitly in the path (e.g., '/1AbCxyz...', '/1AbCxyz.../values/Sheet1!A1:D10')."
   ),
-  queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL"),
-  body: z.unknown().optional().describe(
-    "Request body for POST/PUT. Will be JSON-serialized. Omit for GET."
-  )
+  queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL")
 });
 var outputSchema = z.discriminatedUnion("success", [
   z.object({
@@ -456,13 +438,13 @@ var outputSchema = z.discriminatedUnion("success", [
 ]);
 var requestTool = new ConnectorTool({
   name: "request",
-  description: `Send authenticated requests to the Google Sheets API v4.
-Supports GET (read) and POST/PUT (write: update/append/batchUpdate/clear).
+  description: `Send authenticated read-only requests to the Google Sheets API v4.
+Supports GET only (read: spreadsheets.get / values.get / values:batchGet).
 The caller must include the target spreadsheetId in the path explicitly.
 Authentication is handled automatically via OAuth proxy.`,
   inputSchema,
   outputSchema,
-  async execute({ connectionId, method, path: path2, queryParams, body }, connections, config) {
+  async execute({ connectionId, method, path: path2, queryParams }, connections, config) {
     const connection2 = connections.find((c) => c.id === connectionId);
     if (!connection2) {
       return {
@@ -489,9 +471,6 @@ Authentication is handled automatically via OAuth proxy.`,
       const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
       try {
         const proxyBody = { url, method };
-        if (body !== void 0 && method !== "GET") {
-          proxyBody.body = body;
-        }
         const response = await fetch(proxyUrl, {
           method: "POST",
           headers: {
@@ -521,11 +500,11 @@ Authentication is handled automatically via OAuth proxy.`,
 var requestToolName = `google-sheets-oauth_${requestTool.name}`;
 var googleSheetsOnboarding = new ConnectorOnboarding({
   connectionSetupInstructions: {
-    ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Google Sheets (OAuth) \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306F\u8AAD\u307F\u66F8\u304D\u53EF\u80FD\u306A\u30B9\u30B3\u30FC\u30D7 (\`spreadsheets\`) \u3067\u63A5\u7D9A\u3055\u308C\u3001OAuth\u8A8D\u8A3C\u3057\u305FGoogle\u30A2\u30AB\u30A6\u30F3\u30C8\u304C\u6A29\u9650\u3092\u6301\u3064\u4EFB\u610F\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306B\u5BFE\u3057\u3066\u8AAD\u307F\u66F8\u304D\u3067\u304D\u307E\u3059\u3002
+    ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Google Sheets (OAuth) \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306F\u8AAD\u307F\u53D6\u308A\u5C02\u7528\u30B9\u30B3\u30FC\u30D7 (\`spreadsheets.readonly\`) \u3067\u63A5\u7D9A\u3055\u308C\u3001OAuth\u8A8D\u8A3C\u3057\u305FGoogle\u30A2\u30AB\u30A6\u30F3\u30C8\u304C\u6A29\u9650\u3092\u6301\u3064\u4EFB\u610F\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u3092\u8AAD\u307F\u53D6\u308C\u307E\u3059\u3002
 
-1. \`askUserQuestion\` \u3067\u64CD\u4F5C\u5BFE\u8C61\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8URL\u3092\u30D2\u30A2\u30EA\u30F3\u30B0\u3059\u308B:
+1. \`askUserQuestion\` \u3067\u5BFE\u8C61\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8URL\u3092\u30D2\u30A2\u30EA\u30F3\u30B0\u3059\u308B:
    - \`type\`: \`"freeText"\`
-   - \`question\`: \u300C\u64CD\u4F5C\u3057\u305F\u3044Google Sheets\u306EURL\u3092\u8CBC\u308A\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044\uFF08\u8AAD\u307F\u53D6\u308A\u30FB\u7DE8\u96C6\u3069\u3061\u3089\u3082\u53EF\u80FD\u3067\u3059\uFF09\u300D
+   - \`question\`: \u300C\u8AAD\u307F\u53D6\u308A\u305F\u3044Google Sheets\u306EURL\u3092\u8CBC\u308A\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044\u300D
    - \`placeholder\`: \`"https://docs.google.com/spreadsheets/d/.../edit"\`
 2. \u53D7\u3051\u53D6\u3063\u305FURL\u304B\u3089\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3092\u62BD\u51FA\u3059\u308B\u3002URL\u306E \`/d/\` \u3068 \`/edit\`\uFF08\u307E\u305F\u306F\u672B\u5C3E\uFF09\u306E\u9593\u306B\u3042\u308B\u6587\u5B57\u5217\u304C\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3067\u3059\uFF08\u4F8B: \`https://docs.google.com/spreadsheets/d/1AbCxyz.../edit\` \u2192 \`1AbCxyz...\`\uFF09\u3002URL\u3067\u306F\u306A\u304FID\u3060\u3051\u304C\u6E21\u3055\u308C\u305F\u5834\u5408\u306F\u305D\u306E\u307E\u307E\u5229\u7528\u3057\u307E\u3059\u3002
 3. \`${requestToolName}\` \u3067\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u6027\u3092\u78BA\u8A8D\u3059\u308B:
@@ -540,11 +519,11 @@ var googleSheetsOnboarding = new ConnectorOnboarding({
 - **\u63A5\u7D9A\u8A2D\u5B9A\u4E2D\u306F\u5927\u91CF\u306E\u30BB\u30EB\u5024\u3092\u53D6\u5F97\u3057\u306A\u3044\u3053\u3068**\u3002\u5B9F\u884C\u3057\u3066\u3088\u3044\u306E\u306F\u4E0A\u8A18\u624B\u9806\u3067\u6307\u5B9A\u3055\u308C\u305F\u30E1\u30BF\u30C7\u30FC\u30BF\u53D6\u5F97\u306E\u307F
 - **\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3092\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u30D1\u30E9\u30E1\u30FC\u30BF\u3068\u3057\u3066\u4FDD\u5B58\u3057\u306A\u3044**\u3002\u30CF\u30F3\u30C9\u30E9\u5074\u306E\u30B3\u30FC\u30C9\uFF08\`server-logic\`\uFF09\u306B\u5BFE\u8C61\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8ID\u3092\u76F4\u63A5\u6E21\u3059\u8A2D\u8A08\u306B\u306A\u3063\u3066\u3044\u308B\u305F\u3081\u3001\`updateConnectionParameters\` \u306F\u547C\u3070\u306A\u3044\u3053\u3068
 - \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057\u3002\u4E0D\u8981\u306A\u8AAC\u660E\u306F\u7701\u7565\u3057\u3001\u52B9\u7387\u7684\u306B\u9032\u3081\u308B`,
-    en: `Follow these steps to set up the Google Sheets (OAuth) connection. This connector uses the read/write \`spreadsheets\` scope, so it can read and edit any spreadsheet the authenticated Google account has access to.
+    en: `Follow these steps to set up the Google Sheets (OAuth) connection. This connector uses the read-only \`spreadsheets.readonly\` scope, so it can read any spreadsheet the authenticated Google account has access to.
 
-1. Call \`askUserQuestion\` to ask for the spreadsheet URL the user wants to work with:
+1. Call \`askUserQuestion\` to ask for the spreadsheet URL the user wants to read:
    - \`type\`: \`"freeText"\`
-   - \`question\`: "Please paste the URL of the Google Sheet you want to work with (both read and edit are supported)."
+   - \`question\`: "Please paste the URL of the Google Sheet you want to read."
    - \`placeholder\`: \`"https://docs.google.com/spreadsheets/d/.../edit"\`
 2. Extract the spreadsheet ID from the URL. It is the segment between \`/d/\` and \`/edit\` (or the end of the URL), e.g. \`https://docs.google.com/spreadsheets/d/1AbCxyz.../edit\` \u2192 \`1AbCxyz...\`. If the user pasted just the ID, use it as-is.
 3. Verify accessibility by calling \`${requestToolName}\`:
@@ -579,87 +558,89 @@ async function googleApiFetch(config, url) {
 }
 
 // ../connectors/src/connectors/google-sheets/setup-flow.ts
-var ALL_SPREADSHEETS = "__ALL_SPREADSHEETS__";
 var GOOGLE_SHEETS_SETUP_MAX_SPREADSHEETS = 10;
-var DRIVE_LIST_PAGE_SIZE = 50;
-async function listSpreadsheets(config) {
-  const q = encodeURIComponent(
-    "mimeType='application/vnd.google-apps.spreadsheet' and trashed=false"
-  );
-  const url = `https://www.googleapis.com/drive/v3/files?q=${q}&pageSize=${DRIVE_LIST_PAGE_SIZE}&orderBy=modifiedTime%20desc&fields=files(id,name,modifiedTime)`;
-  const data = await googleApiFetch(config, url);
-  return data.files ?? [];
+function extractSpreadsheetId(raw) {
+  const input = raw.trim();
+  if (input === "") return null;
+  const dMatch = input.match(/\/d\/([a-zA-Z0-9-_]+)/);
+  if (dMatch?.[1]) return dMatch[1];
+  if (/^[a-zA-Z0-9-_]+$/.test(input)) return input;
+  return null;
+}
+function parseSpreadsheetIds(answer) {
+  const ids = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of answer) {
+    for (const token of entry.split(/[\s,]+/)) {
+      const id = extractSpreadsheetId(token);
+      if (id && !seen.has(id)) {
+        seen.add(id);
+        ids.push(id);
+      }
+    }
+  }
+  return ids.slice(0, GOOGLE_SHEETS_SETUP_MAX_SPREADSHEETS);
+}
+function escapeMarkdownTableCell(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
 }
 var googleSheetsSetupFlow = {
   initialState: () => ({}),
   steps: [
     {
       slug: "spreadsheets",
-      type: "multiSelect",
+      type: "text",
       question: {
-        ja: "\u5BFE\u8C61\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u3092\u9078\u3093\u3067\u304F\u3060\u3055\u3044\uFF08\u8907\u6570\u9078\u629E\u53EF\uFF09",
-        en: "Select target spreadsheets (multi-select allowed)"
-      },
-      async fetchOptions(_state, rt) {
-        const files = await listSpreadsheets(rt.config);
-        const fileOptions = files.map((f) => ({
-          value: f.id,
-          label: f.name
-        }));
-        return [
-          {
-            value: ALL_SPREADSHEETS,
-            label: rt.language === "ja" ? "\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u3059\u3079\u3066\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8" : "All accessible spreadsheets"
-          },
-          ...fileOptions
-        ];
+        ja: "\u5BFE\u8C61\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306EURL\uFF08\u307E\u305F\u306FID\uFF09\u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u8907\u6570\u3042\u308B\u5834\u5408\u306F\u6539\u884C\u307E\u305F\u306F\u30AB\u30F3\u30DE\u533A\u5207\u308A\u3067\u5165\u529B\u3067\u304D\u307E\u3059\u3002",
+        en: "Enter the URL (or ID) of the target spreadsheet(s). To specify multiple, separate them with a newline or comma."
       },
-      applyAnswer: (state, answer) => ({ ...state, spreadsheets: answer })
+      applyAnswer: (state, answer) => ({
+        ...state,
+        spreadsheetIds: parseSpreadsheetIds(answer)
+      })
     }
   ],
   async finalize(state, rt) {
-    if (!state.spreadsheets) {
-      throw new Error("Google Sheets setup: incomplete state on finalize");
-    }
-    const targetIds = await resolveSetupSelection({
-      selected: state.spreadsheets,
-      allSentinel: ALL_SPREADSHEETS,
-      fetchAll: async () => {
-        const files = await listSpreadsheets(rt.config);
-        return files.map((f) => f.id);
-      },
-      limit: GOOGLE_SHEETS_SETUP_MAX_SPREADSHEETS
-    });
-    const sections = ["## Google Sheets", ""];
+    const targetIds = state.spreadsheetIds ?? [];
     if (targetIds.length === 0) {
-      sections.push(
-        rt.language === "ja" ? "\u5BFE\u8C61\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u304C\u9078\u629E\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002" : "No spreadsheets selected."
+      throw new Error(
+        rt.language === "ja" ? "\u6709\u52B9\u306A\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306EURL\u307E\u305F\u306FID\u3092\u8A8D\u8B58\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002Google Sheets\u306EURL\uFF08\u4F8B: https://docs.google.com/spreadsheets/d/.../edit\uFF09\u3092\u78BA\u8A8D\u3057\u3066\u5165\u529B\u3057\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\u3002" : "Could not recognize any valid spreadsheet URL or ID. Please re-enter a Google Sheets URL (e.g., https://docs.google.com/spreadsheets/d/.../edit)."
       );
-      return sections.join("\n");
     }
+    const sections = ["## Google Sheets", ""];
     for (const id of targetIds) {
-      const url = `https://sheets.googleapis.com/v4/spreadsheets/${encodeURIComponent(id)}?fields=spreadsheetId,properties(title),sheets(properties(title,sheetId,gridProperties))`;
-      const meta = await googleApiFetch(
-        rt.config,
-        url
-      );
-      const title = meta.properties?.title ?? id;
-      sections.push(`### Spreadsheet: ${title}`, "", `- ID: ${id}`, "");
-      const sheets = meta.sheets ?? [];
-      if (sheets.length === 0) {
-        sections.push("- (no sheet tabs)", "");
-        continue;
-      }
-      sections.push("| Sheet | Rows | Columns |");
-      sections.push("|-------|------|---------|");
-      for (const s of sheets) {
-        const p = s.properties ?? {};
-        const sheetTitle = p.title ?? "(untitled)";
-        const rows = p.gridProperties?.rowCount ?? "-";
-        const cols = p.gridProperties?.columnCount ?? "-";
-        sections.push(`| ${sheetTitle} | ${rows} | ${cols} |`);
+      try {
+        const url = `https://sheets.googleapis.com/v4/spreadsheets/${encodeURIComponent(id)}?fields=spreadsheetId,properties(title),sheets(properties(title,sheetId,gridProperties))`;
+        const meta = await googleApiFetch(
+          rt.config,
+          url
+        );
+        const title = escapeMarkdownTableCell(meta.properties?.title ?? id);
+        sections.push(`### Spreadsheet: ${title}`, "", `- ID: ${id}`, "");
+        const sheets = meta.sheets ?? [];
+        if (sheets.length === 0) {
+          sections.push("- (no sheet tabs)", "");
+          continue;
+        }
+        sections.push("| Sheet | Rows | Columns |");
+        sections.push("|-------|------|---------|");
+        for (const s of sheets) {
+          const p = s.properties ?? {};
+          const sheetTitle = escapeMarkdownTableCell(p.title ?? "(untitled)");
+          const rows = p.gridProperties?.rowCount ?? "-";
+          const cols = p.gridProperties?.columnCount ?? "-";
+          sections.push(`| ${sheetTitle} | ${rows} | ${cols} |`);
+        }
+        sections.push("");
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        sections.push(
+          `### Spreadsheet: ${id}`,
+          "",
+          rt.language === "ja" ? `- \u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${message}` : `- Failed to fetch: ${message}`,
+          ""
+        );
       }
-      sections.push("");
     }
     return sections.join("\n");
   }
@@ -686,7 +667,7 @@ var googleSheetsConnector = new ConnectorPlugin({
   authType: AUTH_TYPES.OAUTH,
   skipConnectionCheckOnCreate: true,
   name: "Google Sheets",
-  description: "Connect to Google Sheets for read/write access via OAuth. Any spreadsheet the authenticated Google account can access is supported \u2014 the target spreadsheetId is passed per call.",
+  description: "Connect to Google Sheets for read-only access via OAuth. Any spreadsheet the authenticated Google account can access is supported \u2014 the target spreadsheetId is passed per call.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/1UPQuggyiZmbb26CuaSr2h/032770e8739b183fa00b7625f024e536/google-sheets.svg",
   parameters,
   releaseFlag: { dev1: true, dev2: false, prod: false },
@@ -696,33 +677,26 @@ var googleSheetsConnector = new ConnectorPlugin({
     allowlist: [
       {
         host: "sheets.googleapis.com",
-        methods: ["GET", "POST", "PUT"]
+        methods: ["GET"]
       }
     ]
   },
   systemPrompt: {
     en: `### Tools (setup-time only)
 
-- \`connector_google-sheets-oauth_request\`: Call the Google Sheets API during setup / data overview. Supports GET, POST, and PUT. The caller must include the target spreadsheetId in the path explicitly (e.g., \`/1AbCxyz...\`, \`/1AbCxyz.../values/Sheet1!A1:D10\`). Authentication is configured automatically via OAuth.
+- \`connector_google-sheets-oauth_request\`: Call the Google Sheets API during setup / data overview. Read-only: only GET is supported. The caller must include the target spreadsheetId in the path explicitly (e.g., \`/1AbCxyz...\`, \`/1AbCxyz.../values/Sheet1!A1:D10\`). Authentication is configured automatically via OAuth.
 
 > **Important**: The \`connector_google-sheets-oauth_request\` tool is only available at setup time. Inside server-logic handlers, use the SDK (\`connection(id).getValues(spreadsheetId, range)\`, 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.
 
-> **Connection scope**: The OAuth scope is \`spreadsheets\` (read/write). A connection is NOT bound to a single spreadsheet \u2014 the target spreadsheetId is passed per call. The spreadsheetId is NOT stored as a connection parameter or environment variable; pass it explicitly from the caller (e.g., as a query param or request input to the handler).
+> **Connection scope**: The OAuth scope is \`spreadsheets.readonly\` (read-only). A connection is NOT bound to a single spreadsheet \u2014 the target spreadsheetId is passed per call. The spreadsheetId is NOT stored as a connection parameter or environment variable; pass it explicitly from the caller (e.g., as a query param or request input to the handler).
 
 ### Google Sheets API Reference
 
-Reads:
+Reads (read-only connection):
 - GET \`/{spreadsheetId}\` \u2014 Get spreadsheet metadata (title, sheets, properties)
 - GET \`/{spreadsheetId}/values/{range}\` \u2014 Get cell values for a range
 - GET \`/{spreadsheetId}/values:batchGet?ranges={range1}&ranges={range2}\` \u2014 Get values for multiple ranges
 
-Writes:
-- PUT \`/{spreadsheetId}/values/{range}?valueInputOption=USER_ENTERED\` \u2014 Overwrite a range (body: \`{ range, majorDimension, values }\`)
-- POST \`/{spreadsheetId}/values/{range}:append?valueInputOption=USER_ENTERED\` \u2014 Append rows after the existing data
-- POST \`/{spreadsheetId}/values/{range}:clear\` \u2014 Clear values in a range
-- POST \`/{spreadsheetId}/values:batchUpdate\` \u2014 Batch update / batch clear
-- POST \`/{spreadsheetId}:batchUpdate\` \u2014 Structural edits (addSheet, deleteSheet, updateCells, formatting, \u2026)
-
 ### Range Notation (A1 notation)
 - \`Sheet1!A1:D10\` \u2014 Specific range on Sheet1
 - \`Sheet1!A:A\` \u2014 Entire column A on Sheet1
@@ -732,7 +706,6 @@ Writes:
 
 ### Tips
 - To explore a spreadsheet, first get metadata to see available sheet names
-- Use \`valueInputOption=USER_ENTERED\` to parse formulas/dates like the UI; use \`RAW\` to store inputs literally
 - Use \`valueRenderOption=FORMATTED_VALUE\` query param to get display values
 - Use \`valueRenderOption=UNFORMATTED_VALUE\` for raw numeric values
 - Use \`majorDimension=COLUMNS\` to get data organized by columns instead of rows
@@ -741,15 +714,11 @@ Writes:
 
 The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below. Do NOT access credentials directly from environment variables and do NOT read \`INTERNAL_SQUADBASE_*\` env vars \u2014 the SDK takes care of OAuth. The target spreadsheetId is NOT stored on the connection \u2014 the handler caller must pass it (as part of the request input).
 
-SDK surface (client created via \`connection(connectionId)\`):
+SDK surface (client created via \`connection(connectionId)\`, read-only):
 - \`client.request(path, init?)\` \u2014 low-level authenticated fetch (\`path\` is appended to \`https://sheets.googleapis.com/v4/spreadsheets\`; the caller must include the target spreadsheetId).
 - \`client.getSpreadsheet(spreadsheetId)\` \u2014 fetch spreadsheet metadata.
 - \`client.getValues(spreadsheetId, range)\` \u2014 read a range (A1 notation).
 - \`client.batchGetValues(spreadsheetId, ranges)\` \u2014 read multiple ranges.
-- \`client.updateValues(spreadsheetId, range, values, valueInputOption?)\` \u2014 overwrite a range (requires write scope).
-- \`client.appendValues(spreadsheetId, range, values, valueInputOption?)\` \u2014 append rows (requires write scope).
-- \`client.clearValues(spreadsheetId, range)\` \u2014 clear a range (requires write scope).
-- \`client.batchUpdate(spreadsheetId, requests)\` \u2014 structural edits (requires write scope).
 
 If a handler test fails with \`Connection proxy is not configured\`, retry \u2014 the sandbox is still initializing. Do NOT abandon the SDK and construct OAuth proxy URLs manually.
 
@@ -765,38 +734,24 @@ const spreadsheetId = "<passed from request input>";
 const metadata = await sheets.getSpreadsheet(spreadsheetId);
 const values = await sheets.getValues(spreadsheetId, "Sheet1!A1:D10");
 
-// Write: overwrite, append, clear
-await sheets.updateValues(spreadsheetId, "Sheet1!A1:B2", [["name", "age"], ["Alice", 30]]);
-await sheets.appendValues(spreadsheetId, "Sheet1!A:B", [["Bob", 25]]);
-await sheets.clearValues(spreadsheetId, "Sheet1!A1:B10");
-
-// Structural edits (add a sheet)
-await sheets.batchUpdate(spreadsheetId, [
-  { addSheet: { properties: { title: "NewSheet" } } },
-]);
+// Read multiple ranges in one request
+const batch = await sheets.batchGetValues(spreadsheetId, ["Sheet1!A1:D10", "Sheet2!A1:B5"]);
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB\uFF08\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306E\u307F\uFF09
 
-- \`connector_google-sheets-oauth_request\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3084\u30C7\u30FC\u30BF\u6982\u8981\u628A\u63E1\u6642\u306B Google Sheets API \u3092\u547C\u3073\u51FA\u3059\u30C4\u30FC\u30EB\u3067\u3059\u3002GET / POST / PUT \u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u547C\u3073\u51FA\u3057\u5074\u304C\u30D1\u30B9\u306B\u5BFE\u8C61\u306E spreadsheetId \u3092\u660E\u793A\u7684\u306B\u542B\u3081\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\uFF08\u4F8B: \`/1AbCxyz...\`\u3001\`/1AbCxyz.../values/Sheet1!A1:D10\`\uFF09\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-sheets-oauth_request\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3084\u30C7\u30FC\u30BF\u6982\u8981\u628A\u63E1\u6642\u306B Google Sheets API \u3092\u547C\u3073\u51FA\u3059\u30C4\u30FC\u30EB\u3067\u3059\u3002\u8AAD\u307F\u53D6\u308A\u5C02\u7528\u3067 GET \u306E\u307F\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u547C\u3073\u51FA\u3057\u5074\u304C\u30D1\u30B9\u306B\u5BFE\u8C61\u306E spreadsheetId \u3092\u660E\u793A\u7684\u306B\u542B\u3081\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\uFF08\u4F8B: \`/1AbCxyz...\`\u3001\`/1AbCxyz.../values/Sheet1!A1:D10\`\uFF09\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
 
 > **\u91CD\u8981**: \`connector_google-sheets-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).getValues(spreadsheetId, range)\` \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
 
-> **\u63A5\u7D9A\u30B9\u30B3\u30FC\u30D7**: OAuth \u30B9\u30B3\u30FC\u30D7\u306F \`spreadsheets\`\uFF08\u8AAD\u307F\u66F8\u304D\u53EF\u80FD\uFF09\u3067\u3059\u3002\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306F\u5358\u4E00\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306B\u7D10\u3065\u304D\u307E\u305B\u3093 \u2014 \u5BFE\u8C61\u306E spreadsheetId \u306F\u547C\u3073\u51FA\u3057\u3054\u3068\u306B\u6E21\u3057\u307E\u3059\u3002spreadsheetId \u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u30D1\u30E9\u30E1\u30FC\u30BF\u3084\u74B0\u5883\u5909\u6570\u3068\u3057\u3066\u4FDD\u5B58\u3055\u308C\u306A\u3044\u305F\u3081\u3001\u30CF\u30F3\u30C9\u30E9\u306E\u547C\u3073\u51FA\u3057\u5143\uFF08\u30EA\u30AF\u30A8\u30B9\u30C8\u5165\u529B\u306A\u3069\uFF09\u304B\u3089\u660E\u793A\u7684\u306B\u6E21\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+> **\u63A5\u7D9A\u30B9\u30B3\u30FC\u30D7**: OAuth \u30B9\u30B3\u30FC\u30D7\u306F \`spreadsheets.readonly\`\uFF08\u8AAD\u307F\u53D6\u308A\u5C02\u7528\uFF09\u3067\u3059\u3002\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306F\u5358\u4E00\u306E\u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306B\u7D10\u3065\u304D\u307E\u305B\u3093 \u2014 \u5BFE\u8C61\u306E spreadsheetId \u306F\u547C\u3073\u51FA\u3057\u3054\u3068\u306B\u6E21\u3057\u307E\u3059\u3002spreadsheetId \u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u30D1\u30E9\u30E1\u30FC\u30BF\u3084\u74B0\u5883\u5909\u6570\u3068\u3057\u3066\u4FDD\u5B58\u3055\u308C\u306A\u3044\u305F\u3081\u3001\u30CF\u30F3\u30C9\u30E9\u306E\u547C\u3073\u51FA\u3057\u5143\uFF08\u30EA\u30AF\u30A8\u30B9\u30C8\u5165\u529B\u306A\u3069\uFF09\u304B\u3089\u660E\u793A\u7684\u306B\u6E21\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 ### Google Sheets API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 
-\u8AAD\u307F\u53D6\u308A:
+\u8AAD\u307F\u53D6\u308A\uFF08\u8AAD\u307F\u53D6\u308A\u5C02\u7528\u63A5\u7D9A\uFF09:
 - GET \`/{spreadsheetId}\` \u2014 \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\uFF08\u30BF\u30A4\u30C8\u30EB\u3001\u30B7\u30FC\u30C8\u3001\u30D7\u30ED\u30D1\u30C6\u30A3\uFF09
 - GET \`/{spreadsheetId}/values/{range}\` \u2014 \u7BC4\u56F2\u306E\u30BB\u30EB\u5024\u3092\u53D6\u5F97
 - GET \`/{spreadsheetId}/values:batchGet?ranges={range1}&ranges={range2}\` \u2014 \u8907\u6570\u7BC4\u56F2\u306E\u5024\u3092\u53D6\u5F97
 
-\u66F8\u304D\u8FBC\u307F:
-- PUT \`/{spreadsheetId}/values/{range}?valueInputOption=USER_ENTERED\` \u2014 \u7BC4\u56F2\u3092\u4E0A\u66F8\u304D\uFF08body: \`{ range, majorDimension, values }\`\uFF09
-- POST \`/{spreadsheetId}/values/{range}:append?valueInputOption=USER_ENTERED\` \u2014 \u65E2\u5B58\u30C7\u30FC\u30BF\u306E\u5F8C\u308D\u306B\u884C\u3092\u8FFD\u8A18
-- POST \`/{spreadsheetId}/values/{range}:clear\` \u2014 \u7BC4\u56F2\u306E\u5024\u3092\u30AF\u30EA\u30A2
-- POST \`/{spreadsheetId}/values:batchUpdate\` \u2014 \u30D0\u30C3\u30C1\u66F4\u65B0 / \u30D0\u30C3\u30C1\u30AF\u30EA\u30A2
-- POST \`/{spreadsheetId}:batchUpdate\` \u2014 \u69CB\u9020\u5909\u66F4\uFF08addSheet, deleteSheet, updateCells, \u66F8\u5F0F\u8A2D\u5B9A \u7B49\uFF09
-
 ### \u7BC4\u56F2\u306E\u8868\u8A18\u6CD5\uFF08A1\u8868\u8A18\u6CD5\uFF09
 - \`Sheet1!A1:D10\` \u2014 Sheet1\u4E0A\u306E\u7279\u5B9A\u7BC4\u56F2
 - \`Sheet1!A:A\` \u2014 Sheet1\u306EA\u5217\u5168\u4F53
@@ -806,7 +761,6 @@ await sheets.batchUpdate(spreadsheetId, [
 
 ### \u30D2\u30F3\u30C8
 - \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u3092\u63A2\u7D22\u3059\u308B\u306B\u306F\u3001\u307E\u305A\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u3066\u5229\u7528\u53EF\u80FD\u306A\u30B7\u30FC\u30C8\u540D\u3092\u78BA\u8A8D\u3057\u307E\u3059
-- \u6570\u5F0F\u3084\u65E5\u4ED8\u3092 UI \u3068\u540C\u3058\u3088\u3046\u306B\u89E3\u91C8\u3055\u305B\u308B\u306B\u306F \`valueInputOption=USER_ENTERED\`\u3001\u305D\u306E\u307E\u307E\u6587\u5B57\u5217\u3068\u3057\u3066\u4FDD\u5B58\u3059\u308B\u306B\u306F \`RAW\` \u3092\u4F7F\u3044\u307E\u3059
 - \u8868\u793A\u5024\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F \`valueRenderOption=FORMATTED_VALUE\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u4F7F\u7528\u3057\u307E\u3059
 - \u751F\u306E\u6570\u5024\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F \`valueRenderOption=UNFORMATTED_VALUE\` \u3092\u4F7F\u7528\u3057\u307E\u3059
 - \u5217\u3054\u3068\u306B\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F \`majorDimension=COLUMNS\` \u3092\u4F7F\u7528\u3057\u307E\u3059
@@ -815,15 +769,11 @@ await sheets.batchUpdate(spreadsheetId, [
 
 \u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BF SDK \u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\`INTERNAL_SQUADBASE_*\` \u306E\u74B0\u5883\u5909\u6570\u3092\u4F7F\u3063\u3066\u624B\u52D5\u3067 OAuth \u30D7\u30ED\u30AD\u30B7\u3092\u53E9\u304F\u3053\u3068\u3082\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044 \u2014 SDK \u304C OAuth \u3092\u51E6\u7406\u3057\u307E\u3059\u3002\u5BFE\u8C61 spreadsheetId \u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u4FDD\u5B58\u3055\u308C\u306A\u3044\u305F\u3081\u3001\u30CF\u30F3\u30C9\u30E9\u306E\u547C\u3073\u51FA\u3057\u5143\uFF08\u30EA\u30AF\u30A8\u30B9\u30C8\u5165\u529B\u306A\u3069\uFF09\u304B\u3089\u6E21\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
-SDK\uFF08\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\uFF09:
+SDK\uFF08\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\u3001\u8AAD\u307F\u53D6\u308A\u5C02\u7528\uFF09:
 - \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\`path\` \u306F \`https://sheets.googleapis.com/v4/spreadsheets\` \u306B\u8FFD\u52A0\u3055\u308C\u3001\u547C\u3073\u51FA\u3057\u5074\u304C spreadsheetId \u3092\u542B\u3081\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\uFF09\u3002
 - \`client.getSpreadsheet(spreadsheetId)\` \u2014 \u30B9\u30D7\u30EC\u30C3\u30C9\u30B7\u30FC\u30C8\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3002
 - \`client.getValues(spreadsheetId, range)\` \u2014 \u7BC4\u56F2\u306E\u5024\u3092\u53D6\u5F97\uFF08A1 \u8868\u8A18\uFF09\u3002
 - \`client.batchGetValues(spreadsheetId, ranges)\` \u2014 \u8907\u6570\u7BC4\u56F2\u306E\u5024\u3092\u53D6\u5F97\u3002
-- \`client.updateValues(spreadsheetId, range, values, valueInputOption?)\` \u2014 \u7BC4\u56F2\u3092\u4E0A\u66F8\u304D\uFF08\u66F8\u304D\u8FBC\u307F\u30B9\u30B3\u30FC\u30D7\u304C\u5FC5\u8981\uFF09\u3002
-- \`client.appendValues(spreadsheetId, range, values, valueInputOption?)\` \u2014 \u884C\u3092\u8FFD\u8A18\uFF08\u66F8\u304D\u8FBC\u307F\u30B9\u30B3\u30FC\u30D7\u304C\u5FC5\u8981\uFF09\u3002
-- \`client.clearValues(spreadsheetId, range)\` \u2014 \u7BC4\u56F2\u306E\u5024\u3092\u30AF\u30EA\u30A2\uFF08\u66F8\u304D\u8FBC\u307F\u30B9\u30B3\u30FC\u30D7\u304C\u5FC5\u8981\uFF09\u3002
-- \`client.batchUpdate(spreadsheetId, requests)\` \u2014 \u69CB\u9020\u5909\u66F4\uFF08\u66F8\u304D\u8FBC\u307F\u30B9\u30B3\u30FC\u30D7\u304C\u5FC5\u8981\uFF09\u3002
 
 \u30CF\u30F3\u30C9\u30E9\u306E\u30C6\u30B9\u30C8\u304C \`Connection proxy is not configured\` \u3067\u5931\u6557\u3059\u308B\u5834\u5408\u306F\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u901A\u5E38\u306F\u30B5\u30F3\u30C9\u30DC\u30C3\u30AF\u30B9\u306E\u521D\u671F\u5316\u4E2D\u306B\u8D77\u304D\u307E\u3059\u3002SDK \u3092\u8AE6\u3081\u3066 OAuth \u30D7\u30ED\u30AD\u30B7\u306E URL \u3092\u81EA\u5206\u3067\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u306F **\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044**\u3002
 
@@ -839,15 +789,8 @@ const spreadsheetId = "<\u30EA\u30AF\u30A8\u30B9\u30C8\u5165\u529B\u304B\u3089\u
 const metadata = await sheets.getSpreadsheet(spreadsheetId);
 const values = await sheets.getValues(spreadsheetId, "Sheet1!A1:D10");
 
-// \u66F8\u304D\u8FBC\u307F: \u4E0A\u66F8\u304D\u30FB\u8FFD\u8A18\u30FB\u30AF\u30EA\u30A2
-await sheets.updateValues(spreadsheetId, "Sheet1!A1:B2", [["name", "age"], ["Alice", 30]]);
-await sheets.appendValues(spreadsheetId, "Sheet1!A:B", [["Bob", 25]]);
-await sheets.clearValues(spreadsheetId, "Sheet1!A1:B10");
-
-// \u69CB\u9020\u5909\u66F4\uFF08\u30B7\u30FC\u30C8\u3092\u8FFD\u52A0\uFF09
-await sheets.batchUpdate(spreadsheetId, [
-  { addSheet: { properties: { title: "NewSheet" } } },
-]);
+// \u8907\u6570\u7BC4\u56F2\u3092\u307E\u3068\u3081\u3066\u53D6\u5F97
+const batch = await sheets.batchGetValues(spreadsheetId, ["Sheet1!A1:D10", "Sheet2!A1:B5"]);
 \`\`\``
   },
   tools,