@squadbase/vite-server 0.1.3-dev.15 → 0.1.3-dev.16

package/dist/connectors/google-slides.js

@@ -1,272 +1,68 @@
-// ../connectors/src/parameter-definition.ts
-var ParameterDefinition = class {
-  slug;
-  name;
-  description;
-  envVarBaseKey;
-  type;
-  secret;
-  required;
-  constructor(config) {
-    this.slug = config.slug;
-    this.name = config.name;
-    this.description = config.description;
-    this.envVarBaseKey = config.envVarBaseKey;
-    this.type = config.type;
-    this.secret = config.secret;
-    this.required = config.required;
+// ../connectors/src/connectors/google-slides/sdk/index.ts
+var SLIDES_BASE_URL = "https://slides.googleapis.com/v1/presentations";
+function createClient(_params, fetchFn = fetch) {
+  function request(path2, init) {
+    const url = `${SLIDES_BASE_URL}${path2 === "" || path2.startsWith("/") ? "" : "/"}${path2}`;
+    return fetchFn(url, init);
   }
-  /**
-   * Get the parameter value from a ConnectorConnectionObject.
-   */
-  getValue(connection2) {
-    const param = connection2.parameters.find(
-      (p) => p.parameterSlug === this.slug
-    );
-    if (!param || param.value == null) {
+  async function getPresentation(presentationId) {
+    const url = `${SLIDES_BASE_URL}/${presentationId}`;
+    const response = await fetchFn(url);
+    if (!response.ok) {
+      const body = await response.text();
       throw new Error(
-        `Parameter "${this.slug}" not found or has no value in connection "${connection2.id}"`
+        `google-slides: getPresentation failed (${response.status}): ${body}`
       );
     }
-    return param.value;
-  }
-  /**
-   * Try to get the parameter value. Returns undefined if not found (for optional params).
-   */
-  tryGetValue(connection2) {
-    const param = connection2.parameters.find(
-      (p) => p.parameterSlug === this.slug
-    );
-    if (!param || param.value == null) return void 0;
-    return param.value;
+    return await response.json();
   }
-};
-
-// ../connectors/src/connectors/google-slides/sdk/index.ts
-import * as crypto from "crypto";
-
-// ../connectors/src/connectors/google-slides/parameters.ts
-var parameters = {
-  serviceAccountKeyJsonBase64: new ParameterDefinition({
-    slug: "service-account-key-json-base64",
-    name: "Google Cloud Service Account JSON",
-    description: "The service account JSON key used to authenticate with Google Cloud Platform. Ensure that the service account has the necessary permissions to access Google Slides.",
-    envVarBaseKey: "GOOGLE_SLIDES_SERVICE_ACCOUNT_JSON_BASE64",
-    type: "base64EncodedJson",
-    secret: true,
-    required: true
-  }),
-  presentationUrl: new ParameterDefinition({
-    slug: "presentation-url",
-    name: "Google Slides Presentation URL",
-    description: "The URL of the Google Slides presentation (e.g., https://docs.google.com/presentation/d/xxxxx/edit). The presentation ID is automatically extracted from the URL.",
-    envVarBaseKey: "GOOGLE_SLIDES_PRESENTATION_URL",
-    type: "text",
-    secret: false,
-    required: false
-  }),
-  sharedDriveId: new ParameterDefinition({
-    slug: "shared-drive-id",
-    name: "Shared Drive ID",
-    description: "The ID of the Google Shared Drive where new presentations will be created. Required for service accounts that do not have their own Drive storage. You can find the ID in the Shared Drive URL: https://drive.google.com/drive/folders/{sharedDriveId}",
-    envVarBaseKey: "GOOGLE_SLIDES_SHARED_DRIVE_ID",
-    type: "text",
-    secret: false,
-    required: false
-  })
-};
-
-// ../connectors/src/connectors/google-slides-oauth/utils.ts
-var PRESENTATION_URL_PATTERN = /docs\.google\.com\/presentation\/d\/([a-zA-Z0-9_-]+)/;
-function extractPresentationId(urlOrId) {
-  const trimmed = urlOrId.trim();
-  const match = trimmed.match(PRESENTATION_URL_PATTERN);
-  if (match) {
-    return match[1];
-  }
-  return trimmed;
-}
-
-// ../connectors/src/connectors/google-slides/sdk/index.ts
-var TOKEN_URL = "https://oauth2.googleapis.com/token";
-var SLIDES_BASE_URL = "https://slides.googleapis.com/v1/presentations";
-var DRIVE_FILES_URL = "https://www.googleapis.com/drive/v3/files";
-var SCOPE = "https://www.googleapis.com/auth/presentations https://www.googleapis.com/auth/drive";
-function base64url(input) {
-  const buf = typeof input === "string" ? Buffer.from(input) : input;
-  return buf.toString("base64url");
-}
-function buildJwt(clientEmail, privateKey, nowSec) {
-  const header = base64url(JSON.stringify({ alg: "RS256", typ: "JWT" }));
-  const payload = base64url(
-    JSON.stringify({
-      iss: clientEmail,
-      scope: SCOPE,
-      aud: TOKEN_URL,
-      iat: nowSec,
-      exp: nowSec + 3600
-    })
-  );
-  const signingInput = `${header}.${payload}`;
-  const sign = crypto.createSign("RSA-SHA256");
-  sign.update(signingInput);
-  sign.end();
-  const signature = base64url(sign.sign(privateKey));
-  return `${signingInput}.${signature}`;
-}
-function createClient(params) {
-  const serviceAccountKeyJsonBase64 = params[parameters.serviceAccountKeyJsonBase64.slug];
-  const presentationUrl = params[parameters.presentationUrl.slug];
-  const defaultPresentationId = presentationUrl ? extractPresentationId(presentationUrl) : void 0;
-  const sharedDriveId = params[parameters.sharedDriveId.slug] || void 0;
-  if (!serviceAccountKeyJsonBase64) {
-    throw new Error(
-      `google-slides: missing required parameter: ${parameters.serviceAccountKeyJsonBase64.slug}`
-    );
-  }
-  let serviceAccountKey;
-  try {
-    const decoded = Buffer.from(
-      serviceAccountKeyJsonBase64,
-      "base64"
-    ).toString("utf-8");
-    serviceAccountKey = JSON.parse(decoded);
-  } catch {
-    throw new Error(
-      "google-slides: failed to decode service account key JSON from base64"
-    );
-  }
-  if (!serviceAccountKey.client_email || !serviceAccountKey.private_key) {
-    throw new Error(
-      "google-slides: service account key JSON must contain client_email and private_key"
-    );
-  }
-  let cachedToken = null;
-  let tokenExpiresAt = 0;
-  async function getAccessToken() {
-    const nowSec = Math.floor(Date.now() / 1e3);
-    if (cachedToken && nowSec < tokenExpiresAt - 60) {
-      return cachedToken;
+  async function getPage(presentationId, pageObjectId) {
+    const url = `${SLIDES_BASE_URL}/${presentationId}/pages/${pageObjectId}`;
+    const response = await fetchFn(url);
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(
+        `google-slides: getPage failed (${response.status}): ${body}`
+      );
     }
-    const jwt = buildJwt(
-      serviceAccountKey.client_email,
-      serviceAccountKey.private_key,
-      nowSec
-    );
-    const response = await fetch(TOKEN_URL, {
+    return await response.json();
+  }
+  async function batchUpdate(presentationId, requests) {
+    const url = `${SLIDES_BASE_URL}/${presentationId}:batchUpdate`;
+    const response = await fetchFn(url, {
       method: "POST",
-      headers: { "Content-Type": "application/x-www-form-urlencoded" },
-      body: new URLSearchParams({
-        grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
-        assertion: jwt
-      })
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ requests })
     });
     if (!response.ok) {
-      const text = await response.text();
+      const body = await response.text();
       throw new Error(
-        `google-slides: token exchange failed (${response.status}): ${text}`
+        `google-slides: batchUpdate failed (${response.status}): ${body}`
       );
     }
-    const data = await response.json();
-    cachedToken = data.access_token;
-    tokenExpiresAt = nowSec + data.expires_in;
-    return cachedToken;
+    return await response.json();
   }
-  function resolvePresentationId(override) {
-    const id = override ?? defaultPresentationId;
-    if (!id) {
+  async function createPresentation(title) {
+    const url = SLIDES_BASE_URL;
+    const response = await fetchFn(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ title })
+    });
+    if (!response.ok) {
+      const body = await response.text();
       throw new Error(
-        "google-slides: presentationId is required. Either configure a default or pass it explicitly."
+        `google-slides: createPresentation failed (${response.status}): ${body}`
       );
     }
-    return id;
-  }
-  async function authenticatedFetch(url, init) {
-    const accessToken = await getAccessToken();
-    const headers = new Headers(init?.headers);
-    headers.set("Authorization", `Bearer ${accessToken}`);
-    if (!headers.has("Content-Type")) {
-      headers.set("Content-Type", "application/json");
-    }
-    return fetch(url, { ...init, headers });
+    return await response.json();
   }
   return {
-    async request(path2, init) {
-      const resolvedPath = defaultPresentationId ? path2.replace(/\{presentationId\}/g, defaultPresentationId) : path2;
-      const url = `${SLIDES_BASE_URL}${resolvedPath.startsWith("/") ? "" : "/"}${resolvedPath}`;
-      return authenticatedFetch(url, init);
-    },
-    async getPresentation(presentationId) {
-      const id = resolvePresentationId(presentationId);
-      const response = await authenticatedFetch(`${SLIDES_BASE_URL}/${id}`);
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(`google-slides: getPresentation failed (${response.status}): ${body}`);
-      }
-      return await response.json();
-    },
-    async getPage(pageObjectId, presentationId) {
-      const id = resolvePresentationId(presentationId);
-      const response = await authenticatedFetch(`${SLIDES_BASE_URL}/${id}/pages/${pageObjectId}`);
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(`google-slides: getPage failed (${response.status}): ${body}`);
-      }
-      return await response.json();
-    },
-    async batchUpdate(requests, presentationId) {
-      const id = resolvePresentationId(presentationId);
-      const response = await authenticatedFetch(`${SLIDES_BASE_URL}/${id}:batchUpdate`, {
-        method: "POST",
-        body: JSON.stringify({ requests })
-      });
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(`google-slides: batchUpdate failed (${response.status}): ${body}`);
-      }
-      return await response.json();
-    },
-    async createPresentation(title) {
-      if (sharedDriveId) {
-        const driveResponse = await authenticatedFetch(
-          `${DRIVE_FILES_URL}?supportsAllDrives=true`,
-          {
-            method: "POST",
-            body: JSON.stringify({
-              name: title,
-              mimeType: "application/vnd.google-apps.presentation",
-              parents: [sharedDriveId]
-            })
-          }
-        );
-        if (!driveResponse.ok) {
-          const body = await driveResponse.text();
-          throw new Error(
-            `google-slides: createPresentation (Drive API) failed (${driveResponse.status}): ${body}`
-          );
-        }
-        const driveFile = await driveResponse.json();
-        const slidesResponse = await authenticatedFetch(
-          `${SLIDES_BASE_URL}/${driveFile.id}`
-        );
-        if (!slidesResponse.ok) {
-          const body = await slidesResponse.text();
-          throw new Error(
-            `google-slides: getPresentation after create failed (${slidesResponse.status}): ${body}`
-          );
-        }
-        return await slidesResponse.json();
-      }
-      const response = await authenticatedFetch(SLIDES_BASE_URL, {
-        method: "POST",
-        body: JSON.stringify({ title })
-      });
-      if (!response.ok) {
-        const body = await response.text();
-        throw new Error(`google-slides: createPresentation failed (${response.status}): ${body}`);
-      }
-      return await response.json();
-    }
+    request,
+    getPresentation,
+    getPage,
+    batchUpdate,
+    createPresentation
   };
 }
 
@@ -352,16 +148,27 @@ var ConnectorPlugin = class _ConnectorPlugin {
    * Filters connections by connectorKey internally.
    * Returns tools keyed as `${connectorKey}_${toolName}`.
    */
-  createTools(connections, config) {
+  createTools(connections, config, opts) {
     const myConnections = connections.filter(
       (c) => _ConnectorPlugin.deriveKey(c.connector.slug, c.connector.authType) === this.connectorKey
     );
     const result = {};
     for (const t of Object.values(this.tools)) {
-      result[`${this.connectorKey}_${t.name}`] = t.createTool(
-        myConnections,
-        config
-      );
+      const tool = t.createTool(myConnections, config);
+      const originalToModelOutput = tool.toModelOutput;
+      result[`${this.connectorKey}_${t.name}`] = {
+        ...tool,
+        toModelOutput: async (options) => {
+          if (!originalToModelOutput) {
+            return opts.truncateOutput(options.output);
+          }
+          const modelOutput = await originalToModelOutput(options);
+          if (modelOutput.type === "text" || modelOutput.type === "json") {
+            return opts.truncateOutput(modelOutput.value);
+          }
+          return modelOutput;
+        }
+      };
     }
     return result;
   }
@@ -383,17 +190,51 @@ var AUTH_TYPES = {
 // ../connectors/src/connectors/google-slides/setup.ts
 var googleSlidesOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Call google-slides_request with GET /{presentationId} to get presentation metadata (title, slide count, layout info)
-2. Call google-slides_request with GET /{presentationId}/pages/{pageObjectId} to inspect individual slide content`,
-    ja: `1. google-slides_request \u3067 GET /{presentationId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\uFF08\u30BF\u30A4\u30C8\u30EB\u3001\u30B9\u30E9\u30A4\u30C9\u6570\u3001\u30EC\u30A4\u30A2\u30A6\u30C8\u60C5\u5831\uFF09\u3092\u53D6\u5F97
-2. google-slides_request \u3067 GET /{presentationId}/pages/{pageObjectId} \u3092\u547C\u3073\u51FA\u3057\u3001\u500B\u5225\u30B9\u30E9\u30A4\u30C9\u306E\u5185\u5BB9\u3092\u78BA\u8A8D`
+    en: `1. Create a new presentation with google-slides_request (POST with body { title: "..." }) or use an existing presentation ID.
+2. Call google-slides_request with GET /{presentationId} to fetch presentation metadata (title, slide count, layout info).`,
+    ja: `1. google-slides_request \u3092 POST\uFF08Body: { title: "..." }\uFF09\u3067\u547C\u3073\u51FA\u3057\u3066\u65B0\u3057\u3044\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3092\u4F5C\u6210\u3059\u308B\u304B\u3001\u65E2\u5B58\u306E\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3ID\u3092\u5229\u7528\u3057\u307E\u3059\u3002
+2. google-slides_request \u3067 GET /{presentationId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\uFF08\u30BF\u30A4\u30C8\u30EB\u3001\u30B9\u30E9\u30A4\u30C9\u6570\u3001\u30EC\u30A4\u30A2\u30A6\u30C8\u60C5\u5831\uFF09\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002`
   }
 });
 
+// ../connectors/src/connectors/google-slides/parameters.ts
+var parameters = {};
+
 // ../connectors/src/connectors/google-slides/tools/request.ts
 import { z } from "zod";
-var BASE_URL = "https://slides.googleapis.com/v1/presentations";
+var SLIDES_BASE_URL2 = "https://slides.googleapis.com/v1/presentations";
 var REQUEST_TIMEOUT_MS = 6e4;
+var cachedToken = null;
+async function getProxyToken(config) {
+  if (cachedToken && cachedToken.expiresAt > Date.now() + 6e4) {
+    return cachedToken.token;
+  }
+  const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": config.appApiKey,
+      "project-id": config.projectId
+    },
+    body: JSON.stringify({
+      sandboxId: config.sandboxId,
+      issuedBy: "coding-agent"
+    })
+  });
+  if (!res.ok) {
+    const errorText = await res.text().catch(() => res.statusText);
+    throw new Error(
+      `Failed to get proxy token: HTTP ${res.status} ${errorText}`
+    );
+  }
+  const data = await res.json();
+  cachedToken = {
+    token: data.token,
+    expiresAt: new Date(data.expiresAt).getTime()
+  };
+  return data.token;
+}
 var inputSchema = z.object({
   toolUseIntent: z.string().optional().describe(
     "Brief description of what you intend to accomplish with this tool call"
@@ -401,7 +242,7 @@ var inputSchema = z.object({
   connectionId: z.string().describe("ID of the Google Slides connection to use"),
   method: z.enum(["GET", "POST"]).describe("HTTP method"),
   path: z.string().describe(
-    "API path appended to https://slides.googleapis.com/v1/presentations (e.g., '/{presentationId}', '/{presentationId}/pages/{pageId}'). {presentationId} is automatically replaced if a default is configured."
+    "API path appended to https://slides.googleapis.com/v1/presentations (e.g., '', '/{presentationId}', '/{presentationId}/pages/{pageId}')."
   ),
   body: z.record(z.string(), z.unknown()).optional().describe("JSON request body for POST requests"),
   queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL")
@@ -421,11 +262,10 @@ var requestTool = new ConnectorTool({
   name: "request",
   description: `Send authenticated requests to the Google Slides API v1.
 Supports GET (read) and POST (create/update) methods.
-Authentication is handled automatically using a service account.
-{presentationId} in the path is automatically replaced with the connection's default presentation ID if configured.`,
+Authentication is handled automatically via OAuth proxy.`,
   inputSchema,
   outputSchema,
-  async execute({ connectionId, method, path: path2, body, queryParams }, connections) {
+  async execute({ connectionId, method, path: path2, body, queryParams }, connections, config) {
     const connection2 = connections.find((c) => c.id === connectionId);
     if (!connection2) {
       return {
@@ -437,52 +277,33 @@ Authentication is handled automatically using a service account.
       `[connector-request] google-slides/${connection2.name}: ${method} ${path2}`
     );
     try {
-      const { GoogleAuth } = await import("google-auth-library");
-      const keyJsonBase64 = parameters.serviceAccountKeyJsonBase64.getValue(connection2);
-      const presentationUrl = parameters.presentationUrl.tryGetValue(connection2);
-      const presentationId = presentationUrl ? extractPresentationId(presentationUrl) : void 0;
-      const credentials = JSON.parse(
-        Buffer.from(keyJsonBase64, "base64").toString("utf-8")
-      );
-      const auth = new GoogleAuth({
-        credentials,
-        scopes: [
-          "https://www.googleapis.com/auth/presentations",
-          "https://www.googleapis.com/auth/drive"
-        ]
-      });
-      const token = await auth.getAccessToken();
-      if (!token) {
-        return {
-          success: false,
-          error: "Failed to obtain access token"
-        };
-      }
-      const resolvedPath = presentationId ? path2.replace(/\{presentationId\}/g, presentationId) : path2;
-      let url = `${BASE_URL}${resolvedPath.startsWith("/") ? "" : "/"}${resolvedPath}`;
+      let url = `${SLIDES_BASE_URL2}${path2 === "" || path2.startsWith("/") ? "" : "/"}${path2}`;
       if (queryParams) {
         const searchParams = new URLSearchParams(queryParams);
         url += `?${searchParams.toString()}`;
       }
+      const token = await getProxyToken(config.oauthProxy);
+      const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
       const controller = new AbortController();
       const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
       try {
-        const response = await fetch(url, {
-          method,
+        const response = await fetch(proxyUrl, {
+          method: "POST",
           headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json"
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${token}`
           },
-          ...body != null ? { body: JSON.stringify(body) } : {},
+          body: JSON.stringify({
+            url,
+            method,
+            ...body != null ? { body: JSON.stringify(body) } : {}
+          }),
           signal: controller.signal
         });
         const data = await response.json();
         if (!response.ok) {
-          const errorObj = data?.error;
-          return {
-            success: false,
-            error: errorObj?.message ?? `HTTP ${response.status} ${response.statusText}`
-          };
+          const errorMessage = typeof data?.error === "string" ? data.error : typeof data?.message === "string" ? data.message : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
         }
         return { success: true, status: response.status, data };
       } finally {
@@ -499,47 +320,62 @@ Authentication is handled automatically using a service account.
 var tools = { request: requestTool };
 var googleSlidesConnector = new ConnectorPlugin({
   slug: "google-slides",
-  authType: AUTH_TYPES.SERVICE_ACCOUNT,
+  authType: AUTH_TYPES.OAUTH,
   name: "Google Slides",
-  description: "Connect to Google Slides for presentation data access and creation using a service account.",
+  description: "Connect to Google Slides for presentation data access and creation using OAuth.",
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/4oyF4yTRpemMA43X49masx/e1582d25e3b4c9a63ba83df2147c1968/google_slide.png",
   parameters,
   releaseFlag: { dev1: true, dev2: false, prod: false },
   onboarding: googleSlidesOnboarding,
+  proxyPolicy: {
+    allowlist: [
+      {
+        host: "slides.googleapis.com",
+        methods: ["GET", "POST"]
+      }
+    ]
+  },
   systemPrompt: {
     en: `### Tools
 
-- \`google-slides_request\`: Send authenticated requests to the Google Slides API v1. Supports GET (read) and POST (create/update) methods. Authentication is configured automatically via service account. The {presentationId} placeholder in paths is automatically replaced with the configured default presentation ID.
+- \`google-slides_request\`: The way to call the Google Slides API. Supports read and write operations. Use it to get presentation metadata, slide content, create new presentations, and modify slides. Authentication is configured automatically via OAuth.
 
 ### Google Slides API Reference
 
 #### Read Endpoints
 - GET \`/{presentationId}\` \u2014 Get presentation metadata (title, slides, layouts, masters)
-- GET \`/{presentationId}/pages/{pageObjectId}\` \u2014 Get a specific slide page with all its elements
+- GET \`/{presentationId}/pages/{pageObjectId}\` \u2014 Get a specific slide page with all its elements (shapes, text, images, tables)
 
 #### Write Endpoints
 - POST \`\` (empty path, with body) \u2014 Create a new presentation. Body: \`{ "title": "My Presentation" }\`
-- POST \`/{presentationId}:batchUpdate\` \u2014 Apply multiple updates. Body: \`{ "requests": [...] }\`
+- POST \`/{presentationId}:batchUpdate\` \u2014 Apply multiple updates to a presentation. Body: \`{ "requests": [...] }\`
 
 #### Common batchUpdate Request Types
-- \`createSlide\` \u2014 Add a new slide
-- \`insertText\` \u2014 Insert text into a shape
-- \`createShape\` \u2014 Add a shape to a slide
-- \`createImage\` \u2014 Add an image
-- \`deleteObject\` \u2014 Delete a page element or slide
-- \`replaceAllText\` \u2014 Find & replace text
-- \`updateTextStyle\` \u2014 Style text (bold, color, font)
+- \`createSlide\` \u2014 Add a new slide: \`{ "createSlide": { "insertionIndex": 1, "slideLayoutReference": { "predefinedLayout": "BLANK" } } }\`
+- \`insertText\` \u2014 Insert text into a shape: \`{ "insertText": { "objectId": "shapeId", "text": "Hello" } }\`
+- \`createShape\` \u2014 Add a shape to a slide: \`{ "createShape": { "shapeType": "TEXT_BOX", "elementProperties": { "pageObjectId": "slideId", "size": {...}, "transform": {...} } } }\`
+- \`createImage\` \u2014 Add an image: \`{ "createImage": { "url": "https://...", "elementProperties": { "pageObjectId": "slideId" } } }\`
+- \`deleteObject\` \u2014 Delete a page element or slide: \`{ "deleteObject": { "objectId": "objectId" } }\`
+- \`replaceAllText\` \u2014 Find & replace text: \`{ "replaceAllText": { "containsText": { "text": "old" }, "replaceText": "new" } }\`
+- \`updateTextStyle\` \u2014 Style text (bold, color, font): \`{ "updateTextStyle": { "objectId": "shapeId", "style": { "bold": true }, "textRange": { "type": "ALL" }, "fields": "bold" } }\`
+- \`updateShapeProperties\` \u2014 Update shape fill, outline, etc.
+- \`createTable\` \u2014 Create a table on a slide
+- \`insertTableRows\` / \`insertTableColumns\` \u2014 Add rows/columns to a table
+- \`deleteTableRow\` / \`deleteTableColumn\` \u2014 Remove rows/columns
 
 #### Predefined Slide Layouts
-\`BLANK\`, \`TITLE\`, \`TITLE_AND_BODY\`, \`TITLE_AND_TWO_COLUMNS\`, \`TITLE_ONLY\`, \`SECTION_HEADER\`, \`ONE_COLUMN_TEXT\`, \`MAIN_POINT\`, \`BIG_NUMBER\`
+\`BLANK\`, \`CAPTION_ONLY\`, \`TITLE\`, \`TITLE_AND_BODY\`, \`TITLE_AND_TWO_COLUMNS\`, \`TITLE_ONLY\`, \`SECTION_HEADER\`, \`SECTION_TITLE_AND_DESCRIPTION\`, \`ONE_COLUMN_TEXT\`, \`MAIN_POINT\`, \`BIG_NUMBER\`
 
 ### Tips
-- Use \`{presentationId}\` placeholder in paths \u2014 automatically replaced
-- Shape sizes use EMU: 1 inch = 914400 EMU, 1 pt = 12700 EMU
+- To explore a presentation, first GET the presentation metadata to see available slide object IDs
+- When inserting text or shapes, you need the \`pageObjectId\` of the target slide (from the metadata)
+- batchUpdate requests are applied in order \u2014 use this for complex multi-step modifications
+- Shape sizes and positions use EMU (English Metric Units): 1 inch = 914400 EMU, 1 pt = 12700 EMU
+- Sharing (permissions) cannot be done via this connector; only the OAuth user has access to the created presentations
 
 ### Business Logic
 
-The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below.
+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.
 
 #### Example
 
@@ -548,47 +384,64 @@ import { connection } from "@squadbase/vite-server/connectors/google-slides";
 
 const slides = connection("<connectionId>");
 
-const presentation = await slides.getPresentation();
+// Create a new presentation
+const newPres = await slides.createPresentation("Quarterly Report");
+const presentationId = newPres.presentationId;
+
+// Get presentation metadata
+const presentation = await slides.getPresentation(presentationId);
 console.log(presentation.title, presentation.slides.length);
 
-const newPres = await slides.createPresentation("Report");
-await slides.batchUpdate([
+// Get a specific slide's content
+const page = await slides.getPage(presentationId, presentation.slides[0].objectId);
+console.log(page.pageElements);
+
+// Add a slide and insert text
+await slides.batchUpdate(presentationId, [
   { createSlide: { insertionIndex: 1, slideLayoutReference: { predefinedLayout: "TITLE_AND_BODY" } } },
+  { insertText: { objectId: "someShapeId", text: "Hello, World!" } },
 ]);
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`google-slides_request\`: Google Slides API v1\u3078\u306E\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002GET\uFF08\u8AAD\u307F\u53D6\u308A\uFF09\u3068POST\uFF08\u4F5C\u6210/\u66F4\u65B0\uFF09\u30E1\u30BD\u30C3\u30C9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u30B5\u30FC\u30D3\u30B9\u30A2\u30AB\u30A6\u30F3\u30C8\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{presentationId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u8A2D\u5B9A\u6E08\u307F\u306E\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3ID\u3067\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
+- \`google-slides_request\`: Google Slides API\u3092\u547C\u3073\u51FA\u3059\u624B\u6BB5\u3067\u3059\u3002\u8AAD\u307F\u53D6\u308A\u3068\u66F8\u304D\u8FBC\u307F\u306E\u4E21\u65B9\u3092\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u30FB\u30B9\u30E9\u30A4\u30C9\u5185\u5BB9\u306E\u53D6\u5F97\u3001\u65B0\u3057\u3044\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u4F5C\u6210\u3001\u30B9\u30E9\u30A4\u30C9\u306E\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
 
 ### Google Slides API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 
 #### \u8AAD\u307F\u53D6\u308A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
-- GET \`/{presentationId}\` \u2014 \u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97
-- GET \`/{presentationId}/pages/{pageObjectId}\` \u2014 \u7279\u5B9A\u306E\u30B9\u30E9\u30A4\u30C9\u30DA\u30FC\u30B8\u3068\u305D\u306E\u5168\u8981\u7D20\u3092\u53D6\u5F97
+- GET \`/{presentationId}\` \u2014 \u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\uFF08\u30BF\u30A4\u30C8\u30EB\u3001\u30B9\u30E9\u30A4\u30C9\u3001\u30EC\u30A4\u30A2\u30A6\u30C8\u3001\u30DE\u30B9\u30BF\u30FC\uFF09
+- GET \`/{presentationId}/pages/{pageObjectId}\` \u2014 \u7279\u5B9A\u306E\u30B9\u30E9\u30A4\u30C9\u30DA\u30FC\u30B8\u3068\u305D\u306E\u5168\u8981\u7D20\uFF08\u56F3\u5F62\u3001\u30C6\u30AD\u30B9\u30C8\u3001\u753B\u50CF\u3001\u30C6\u30FC\u30D6\u30EB\uFF09\u3092\u53D6\u5F97
 
 #### \u66F8\u304D\u8FBC\u307F\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
 - POST \`\`\uFF08\u7A7A\u30D1\u30B9\u3001\u30DC\u30C7\u30A3\u4ED8\u304D\uFF09\u2014 \u65B0\u3057\u3044\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3092\u4F5C\u6210\u3002Body: \`{ "title": "\u30DE\u30A4\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3" }\`
-- POST \`/{presentationId}:batchUpdate\` \u2014 \u8907\u6570\u306E\u66F4\u65B0\u3092\u9069\u7528\u3002Body: \`{ "requests": [...] }\`
+- POST \`/{presentationId}:batchUpdate\` \u2014 \u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306B\u8907\u6570\u306E\u66F4\u65B0\u3092\u9069\u7528\u3002Body: \`{ "requests": [...] }\`
 
 #### \u4E3B\u306A batchUpdate \u30EA\u30AF\u30A8\u30B9\u30C8\u30BF\u30A4\u30D7
-- \`createSlide\` \u2014 \u30B9\u30E9\u30A4\u30C9\u3092\u8FFD\u52A0
-- \`insertText\` \u2014 \u30C6\u30AD\u30B9\u30C8\u3092\u633F\u5165
-- \`createShape\` \u2014 \u56F3\u5F62\u3092\u8FFD\u52A0
-- \`createImage\` \u2014 \u753B\u50CF\u3092\u8FFD\u52A0
-- \`deleteObject\` \u2014 \u8981\u7D20\u307E\u305F\u306F\u30B9\u30E9\u30A4\u30C9\u3092\u524A\u9664
-- \`replaceAllText\` \u2014 \u30C6\u30AD\u30B9\u30C8\u306E\u691C\u7D22\u3068\u7F6E\u63DB
-- \`updateTextStyle\` \u2014 \u30C6\u30AD\u30B9\u30C8\u306E\u30B9\u30BF\u30A4\u30EB\u8A2D\u5B9A
+- \`createSlide\` \u2014 \u30B9\u30E9\u30A4\u30C9\u3092\u8FFD\u52A0: \`{ "createSlide": { "insertionIndex": 1, "slideLayoutReference": { "predefinedLayout": "BLANK" } } }\`
+- \`insertText\` \u2014 \u56F3\u5F62\u306B\u30C6\u30AD\u30B9\u30C8\u3092\u633F\u5165: \`{ "insertText": { "objectId": "shapeId", "text": "Hello" } }\`
+- \`createShape\` \u2014 \u30B9\u30E9\u30A4\u30C9\u306B\u56F3\u5F62\u3092\u8FFD\u52A0: \`{ "createShape": { "shapeType": "TEXT_BOX", "elementProperties": { "pageObjectId": "slideId", "size": {...}, "transform": {...} } } }\`
+- \`createImage\` \u2014 \u753B\u50CF\u3092\u8FFD\u52A0: \`{ "createImage": { "url": "https://...", "elementProperties": { "pageObjectId": "slideId" } } }\`
+- \`deleteObject\` \u2014 \u30DA\u30FC\u30B8\u8981\u7D20\u307E\u305F\u306F\u30B9\u30E9\u30A4\u30C9\u3092\u524A\u9664: \`{ "deleteObject": { "objectId": "objectId" } }\`
+- \`replaceAllText\` \u2014 \u30C6\u30AD\u30B9\u30C8\u306E\u691C\u7D22\u3068\u7F6E\u63DB: \`{ "replaceAllText": { "containsText": { "text": "\u53E4\u3044" }, "replaceText": "\u65B0\u3057\u3044" } }\`
+- \`updateTextStyle\` \u2014 \u30C6\u30AD\u30B9\u30C8\u306E\u30B9\u30BF\u30A4\u30EB\u8A2D\u5B9A\uFF08\u592A\u5B57\u3001\u8272\u3001\u30D5\u30A9\u30F3\u30C8\uFF09: \`{ "updateTextStyle": { "objectId": "shapeId", "style": { "bold": true }, "textRange": { "type": "ALL" }, "fields": "bold" } }\`
+- \`updateShapeProperties\` \u2014 \u56F3\u5F62\u306E\u5857\u308A\u3064\u3076\u3057\u3001\u30A2\u30A6\u30C8\u30E9\u30A4\u30F3\u306A\u3069\u3092\u66F4\u65B0
+- \`createTable\` \u2014 \u30B9\u30E9\u30A4\u30C9\u306B\u30C6\u30FC\u30D6\u30EB\u3092\u4F5C\u6210
+- \`insertTableRows\` / \`insertTableColumns\` \u2014 \u30C6\u30FC\u30D6\u30EB\u306B\u884C/\u5217\u3092\u8FFD\u52A0
+- \`deleteTableRow\` / \`deleteTableColumn\` \u2014 \u884C/\u5217\u3092\u524A\u9664
 
 #### \u5B9A\u7FA9\u6E08\u307F\u30B9\u30E9\u30A4\u30C9\u30EC\u30A4\u30A2\u30A6\u30C8
-\`BLANK\`, \`TITLE\`, \`TITLE_AND_BODY\`, \`TITLE_AND_TWO_COLUMNS\`, \`TITLE_ONLY\`, \`SECTION_HEADER\`, \`ONE_COLUMN_TEXT\`, \`MAIN_POINT\`, \`BIG_NUMBER\`
+\`BLANK\`, \`CAPTION_ONLY\`, \`TITLE\`, \`TITLE_AND_BODY\`, \`TITLE_AND_TWO_COLUMNS\`, \`TITLE_ONLY\`, \`SECTION_HEADER\`, \`SECTION_TITLE_AND_DESCRIPTION\`, \`ONE_COLUMN_TEXT\`, \`MAIN_POINT\`, \`BIG_NUMBER\`
 
 ### \u30D2\u30F3\u30C8
-- \u30D1\u30B9\u306B \`{presentationId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u3092\u4F7F\u7528 \u2014 \u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059
-- \u56F3\u5F62\u30B5\u30A4\u30BA\u306FEMU\u3092\u4F7F\u7528: 1\u30A4\u30F3\u30C1 = 914400 EMU\u30011pt = 12700 EMU
+- \u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3092\u63A2\u7D22\u3059\u308B\u306B\u306F\u3001\u307E\u305AGET\u3067\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97\u3057\u3066\u5229\u7528\u53EF\u80FD\u306A\u30B9\u30E9\u30A4\u30C9\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8ID\u3092\u78BA\u8A8D\u3057\u307E\u3059
+- \u30C6\u30AD\u30B9\u30C8\u3084\u56F3\u5F62\u3092\u633F\u5165\u3059\u308B\u969B\u306F\u3001\u5BFE\u8C61\u30B9\u30E9\u30A4\u30C9\u306E \`pageObjectId\` \u304C\u5FC5\u8981\u3067\u3059\uFF08\u30E1\u30BF\u30C7\u30FC\u30BF\u304B\u3089\u53D6\u5F97\uFF09
+- batchUpdate\u30EA\u30AF\u30A8\u30B9\u30C8\u306F\u9806\u756A\u306B\u9069\u7528\u3055\u308C\u307E\u3059 \u2014 \u8907\u96D1\u306A\u8907\u6570\u30B9\u30C6\u30C3\u30D7\u306E\u5909\u66F4\u306B\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044
+- \u56F3\u5F62\u306E\u30B5\u30A4\u30BA\u3068\u4F4D\u7F6E\u306FEMU\uFF08English Metric Units\uFF09\u3092\u4F7F\u7528: 1\u30A4\u30F3\u30C1 = 914400 EMU\u30011pt = 12700 EMU
+- \u5171\u6709\uFF08permissions\uFF09\u306F\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u7D4C\u7531\u3067\u306F\u884C\u3048\u307E\u305B\u3093\u3002\u4F5C\u6210\u3057\u305F\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3078\u306F\u63A5\u7D9A\u3057\u305FOAuth\u30E6\u30FC\u30B6\u30FC\u306E\u307F\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u3067\u3059
 
 ### Business Logic
 
-\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\u306ESDK\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+\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\u30BFSDK\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
 
 #### Example
 
@@ -597,12 +450,22 @@ import { connection } from "@squadbase/vite-server/connectors/google-slides";
 
 const slides = connection("<connectionId>");
 
-const presentation = await slides.getPresentation();
+// \u65B0\u3057\u3044\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3092\u4F5C\u6210
+const newPres = await slides.createPresentation("\u56DB\u534A\u671F\u30EC\u30DD\u30FC\u30C8");
+const presentationId = newPres.presentationId;
+
+// \u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u306E\u30E1\u30BF\u30C7\u30FC\u30BF\u3092\u53D6\u5F97
+const presentation = await slides.getPresentation(presentationId);
 console.log(presentation.title, presentation.slides.length);
 
-const newPres = await slides.createPresentation("\u30EC\u30DD\u30FC\u30C8");
-await slides.batchUpdate([
+// \u7279\u5B9A\u306E\u30B9\u30E9\u30A4\u30C9\u306E\u5185\u5BB9\u3092\u53D6\u5F97
+const page = await slides.getPage(presentationId, presentation.slides[0].objectId);
+console.log(page.pageElements);
+
+// \u30B9\u30E9\u30A4\u30C9\u3092\u8FFD\u52A0\u3057\u3066\u30C6\u30AD\u30B9\u30C8\u3092\u633F\u5165
+await slides.batchUpdate(presentationId, [
   { createSlide: { insertionIndex: 1, slideLayoutReference: { predefinedLayout: "TITLE_AND_BODY" } } },
+  { insertText: { objectId: "someShapeId", text: "Hello, World!" } },
 ]);
 \`\`\``
   },