@tool-bridge/server 0.1.0 → 0.3.0

package/dist/googledocs-WSGLPKSF.js

@@ -0,0 +1,1322 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/googledocs/api/shared.ts
+var SERVICE = "googledocs";
+var DOCS_API_BASE = "https://docs.googleapis.com/v1";
+var DRIVE_API_BASE = "https://www.googleapis.com/drive/v3";
+var SHEETS_API_BASE = "https://sheets.googleapis.com/v4";
+var REQUEST_TIMEOUT_MS = 3e4;
+var MAX_ERROR_MESSAGE_LENGTH = 500;
+var BASE64_CHUNK = 8192;
+var RATE_LIMIT_REASONS = /* @__PURE__ */ new Set([
+  "rateLimitExceeded",
+  "userRateLimitExceeded",
+  "quotaExceeded",
+  "dailyLimitExceeded"
+]);
+var DRIVE_FILE_FIELDS = [
+  "id",
+  "name",
+  "mimeType",
+  "webViewLink",
+  "createdTime",
+  "modifiedTime",
+  "driveId",
+  "parents",
+  "owners(displayName,emailAddress,permissionId,photoLink)",
+  "shared",
+  "starred",
+  "trashed"
+].join(",");
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function optionalText(value) {
+  return value === void 0 || value === "" ? void 0 : value;
+}
+function compact(input) {
+  return Object.fromEntries(
+    Object.entries(input).filter((entry) => entry[1] !== void 0)
+  );
+}
+function requireRecord(value, label) {
+  const result = record(value);
+  if (result === void 0) throw new TBError("unavailable", `${label}\u4E0D\u662F\u5BF9\u8C61`, { retryable: true });
+  return result;
+}
+function objectArray(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((item) => {
+    const fields = record(item);
+    return fields === void 0 ? [] : [fields];
+  });
+}
+function nestedText(value, path) {
+  let current = value;
+  for (const key of path) {
+    const fields = record(current);
+    if (fields === void 0) return void 0;
+    current = fields[key];
+  }
+  return typeof current === "string" ? optionalText(current) : void 0;
+}
+function nestedNumber(value, path) {
+  let current = value;
+  for (const key of path) {
+    const fields = record(current);
+    if (fields === void 0) return void 0;
+    current = fields[key];
+  }
+  return typeof current === "number" ? current : void 0;
+}
+function requireNonBlank(value, field) {
+  if (value === void 0 || value.trim() === "") {
+    throw new TBError("invalid_argument", `${field} is required`);
+  }
+  return value;
+}
+function extractId(value, pattern) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    return value;
+  }
+  return url.toString().match(pattern)?.[1] ?? value;
+}
+function requireDocumentId(value, field) {
+  return extractId(requireNonBlank(value, field), /\/document\/d\/([^/?#]+)/u);
+}
+function requireSpreadsheetId(value, field) {
+  return extractId(requireNonBlank(value, field), /\/spreadsheets\/d\/([^/?#]+)/u);
+}
+function requireFileId(value, field) {
+  const raw = requireNonBlank(value, field);
+  const fromDocument = extractId(raw, /\/document\/d\/([^/?#]+)/u);
+  if (fromDocument !== raw) return fromDocument;
+  return extractId(raw, /\/spreadsheets\/d\/([^/?#]+)/u);
+}
+function buildUrl(url, query) {
+  const target = new URL(url);
+  for (const [key, value] of Object.entries(query ?? {})) {
+    if (value !== void 0) target.searchParams.set(key, value);
+  }
+  return target.toString();
+}
+function truncate(value) {
+  return value.length <= MAX_ERROR_MESSAGE_LENGTH ? value : `${value.slice(0, MAX_ERROR_MESSAGE_LENGTH)}\u2026`;
+}
+async function readError(response) {
+  const raw = await response.text().catch(() => "");
+  if (raw === "") return { message: `Google Docs \u8FD4\u56DE HTTP ${response.status}`, reasons: [] };
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    return { message: truncate(raw), reasons: [] };
+  }
+  const body = record(payload);
+  const error = record(body?.error);
+  const reasons = Array.isArray(error?.errors) ? error.errors.map((item) => nestedText(record(item), ["reason"])).filter((item) => item !== void 0) : [];
+  const message = nestedText(error, ["message"]) ?? nestedText(body, ["error_description"]) ?? truncate(raw);
+  return { message, reasons };
+}
+async function docsError(response) {
+  const { message, reasons } = await readError(response);
+  if (response.status === 403 && reasons.some((reason) => RATE_LIMIT_REASONS.has(reason))) {
+    return upstreamError(429, message);
+  }
+  return upstreamError(response.status, message);
+}
+async function send(ctx, input) {
+  const accessToken = requireApiKey(ctx, SERVICE);
+  const hasBody = input.body !== void 0;
+  let response;
+  try {
+    response = await guardedFetch(buildUrl(input.url, input.query), {
+      method: input.method ?? (hasBody ? "POST" : "GET"),
+      headers: {
+        accept: "application/json",
+        authorization: `Bearer ${accessToken}`,
+        ...hasBody ? { "content-type": "application/json" } : {}
+      },
+      body: hasBody ? JSON.stringify(input.body) : void 0,
+      // 不设超时会让一个挂死的端点拖住整个调用;上游同样给了 30s 的独立预算。
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    if (error instanceof Error && error.name === "TimeoutError") {
+      throw upstreamError(504, `Google Docs \u8BF7\u6C42\u8D85\u65F6(${REQUEST_TIMEOUT_MS / 1e3} \u79D2)`);
+    }
+    const message = error instanceof Error ? error.message : "unknown network error";
+    throw upstreamError(502, `Google Docs \u8BF7\u6C42\u5931\u8D25:${message}`);
+  }
+  if (!response.ok) throw await docsError(response);
+  return response;
+}
+async function requestJson(ctx, input) {
+  const response = await send(ctx, input);
+  const body = await response.text();
+  if (body === "") {
+    throw new TBError("unavailable", "Google Docs \u5728\u5E94\u56DE JSON \u7684\u5730\u65B9\u56DE\u4E86\u7A7A\u54CD\u5E94\u4F53", { retryable: true });
+  }
+  try {
+    return JSON.parse(body);
+  } catch {
+    throw new TBError("unavailable", "Google Docs \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94", { retryable: true });
+  }
+}
+async function requestRecord(ctx, input) {
+  return requireRecord(await requestJson(ctx, input), "Google Docs \u54CD\u5E94");
+}
+function base64(bytes) {
+  let binary = "";
+  for (let offset = 0; offset < bytes.length; offset += BASE64_CHUNK) {
+    binary += String.fromCharCode(...bytes.subarray(offset, offset + BASE64_CHUNK));
+  }
+  return btoa(binary);
+}
+async function runBatch(ctx, documentId, requests, writeControl) {
+  const payload = await requestRecord(ctx, {
+    url: `${DOCS_API_BASE}/documents/${documentId}:batchUpdate`,
+    method: "POST",
+    body: compact({ requests, writeControl })
+  });
+  return {
+    documentId,
+    replies: objectArray(payload.replies),
+    // 上游只在 Google 真的回了 writeControl 时才透出这个键。
+    ...record(payload.writeControl) === void 0 ? {} : { writeControl: record(payload.writeControl) }
+  };
+}
+async function runSingle(ctx, documentId, request, extra) {
+  const output = await runBatch(ctx, documentId, [request]);
+  return { ...output, ...extra };
+}
+function documentSummary(document) {
+  const documentId = typeof document.documentId === "string" ? document.documentId : "";
+  return {
+    documentId: extractId(documentId, /\/document\/d\/([^/?#]+)/u),
+    title: typeof document.title === "string" ? document.title : "",
+    revisionId: nestedText(document, ["revisionId"]) ?? null
+  };
+}
+function documentDetail(document) {
+  const containers = ["body", "headers", "footers", "footnotes", "documentStyle", "namedRanges", "inlineObjects", "lists"];
+  const detail = documentSummary(document);
+  for (const key of containers) {
+    const value = record(document[key]);
+    if (value !== void 0) detail[key] = value;
+  }
+  if (Array.isArray(document.tabs)) detail.tabs = objectArray(document.tabs);
+  return detail;
+}
+function driveFile(payload) {
+  const owners = Array.isArray(payload.owners) ? objectArray(payload.owners).map((owner) => ({
+    displayName: nestedText(owner, ["displayName"]) ?? null,
+    emailAddress: nestedText(owner, ["emailAddress"]) ?? null,
+    permissionId: nestedText(owner, ["permissionId"]) ?? null,
+    photoLink: nestedText(owner, ["photoLink"]) ?? null
+  })) : void 0;
+  const parents = Array.isArray(payload.parents) ? payload.parents.filter((item) => typeof item === "string") : void 0;
+  return compact({
+    id: typeof payload.id === "string" ? payload.id : "",
+    name: typeof payload.name === "string" ? payload.name : "",
+    mimeType: typeof payload.mimeType === "string" ? payload.mimeType : "",
+    webViewLink: nestedText(payload, ["webViewLink"]) ?? null,
+    createdTime: nestedText(payload, ["createdTime"]) ?? null,
+    modifiedTime: nestedText(payload, ["modifiedTime"]) ?? null,
+    driveId: nestedText(payload, ["driveId"]) ?? null,
+    parents,
+    owners,
+    // 三个布尔只在 Google 明确给了布尔时才透出(上游用 typeof 判,不给缺省值)。
+    shared: typeof payload.shared === "boolean" ? payload.shared : void 0,
+    starred: typeof payload.starred === "boolean" ? payload.starred : void 0,
+    trashed: typeof payload.trashed === "boolean" ? payload.trashed : void 0
+  });
+}
+
+// ../plugins/src/googledocs/api/batch.ts
+async function createFooter(input, ctx) {
+  const documentId = requireDocumentId(input.document_id, "document_id");
+  const output = await runSingle(ctx, documentId, {
+    createFooter: compact({
+      type: input.type,
+      sectionBreakLocation: input.section_break_location
+    })
+  });
+  return compact({
+    ...output,
+    footerId: nestedText(output.replies[0], ["createFooter", "footerId"])
+  });
+}
+async function createFootnote(input, ctx) {
+  const documentId = requireDocumentId(input.documentId, "documentId");
+  const output = await runSingle(ctx, documentId, {
+    createFootnote: compact({
+      location: input.location,
+      endOfSegmentLocation: input.endOfSegmentLocation
+    })
+  });
+  return compact({
+    ...output,
+    footnoteId: nestedText(output.replies[0], ["createFootnote", "footnoteId"])
+  });
+}
+async function createHeader(input, ctx) {
+  const documentId = requireDocumentId(input.documentId, "documentId");
+  const created = await runSingle(ctx, documentId, {
+    createHeader: compact({
+      type: optionalText(input.type),
+      sectionBreakLocation: input.sectionBreakLocation
+    })
+  });
+  const headerId = nestedText(created.replies[0], ["createHeader", "headerId"]);
+  const text = optionalText(input.text);
+  if (headerId === void 0 || text === void 0) {
+    return compact({ ...created, headerId });
+  }
+  const inserted = await runSingle(ctx, documentId, {
+    insertText: { text, endOfSegmentLocation: { segmentId: headerId } }
+  });
+  return compact({
+    documentId,
+    headerId,
+    insertedTextLength: text.length,
+    // 两步的 replies 首尾相接:调用方按 request 顺序读它们。
+    replies: [...created.replies, ...inserted.replies],
+    writeControl: inserted.writeControl
+  });
+}
+async function createNamedRange(input, ctx) {
+  const documentId = requireDocumentId(input.documentId, "documentId");
+  const output = await runSingle(ctx, documentId, {
+    createNamedRange: {
+      name: input.name,
+      range: compact({
+        startIndex: input.rangeStartIndex,
+        endIndex: input.rangeEndIndex,
+        segmentId: optionalText(input.rangeSegmentId)
+      })
+    }
+  });
+  return compact({
+    ...output,
+    name: input.name,
+    namedRangeId: nestedText(output.replies[0], ["createNamedRange", "namedRangeId"])
+  });
+}
+function createParagraphBullets(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.document_id, "document_id"), {
+    createParagraphBullets: input.createParagraphBullets
+  });
+}
+function deleteContentRange(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.document_id, "document_id"), {
+    deleteContentRange: { range: input.range }
+  });
+}
+function deleteFooter(input, ctx) {
+  return runSingle(
+    ctx,
+    requireDocumentId(input.document_id, "document_id"),
+    { deleteFooter: compact({ footerId: input.footer_id, tabId: optionalText(input.tab_id) }) },
+    // 上游把被删的 id 回显在出参里,方便调用方对账。
+    { footerId: input.footer_id }
+  );
+}
+function deleteHeader(input, ctx) {
+  return runSingle(
+    ctx,
+    requireDocumentId(input.document_id, "document_id"),
+    { deleteHeader: compact({ headerId: input.header_id, tabId: optionalText(input.tab_id) }) },
+    { headerId: input.header_id }
+  );
+}
+function deleteNamedRange(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.document_id, "document_id"), {
+    deleteNamedRange: input.deleteNamedRange
+  });
+}
+function deleteParagraphBullets(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.document_id, "document_id"), {
+    deleteParagraphBullets: compact({ range: input.range, tabId: optionalText(input.tab_id) })
+  });
+}
+function deleteTableColumn(input, ctx) {
+  return runBatch(ctx, requireDocumentId(input.document_id, "document_id"), input.requests);
+}
+function deleteTableRow(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.documentId, "documentId"), {
+    deleteTableRow: { tableCellLocation: input.tableCellLocation }
+  });
+}
+async function insertInlineImage(input, ctx) {
+  const documentId = requireDocumentId(input.documentId, "documentId");
+  const output = await runSingle(ctx, documentId, {
+    insertInlineImage: compact({
+      uri: input.uri,
+      location: input.location,
+      objectSize: input.objectSize
+    })
+  });
+  return {
+    ...output,
+    // 这个键上游明确给 null 兜底(不像 footerId 那样省掉):调用方要拿它接着改图片样式。
+    inlineObjectId: nestedText(output.replies[0], ["insertInlineImage", "objectId"]) ?? null
+  };
+}
+function insertPageBreak(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.documentId, "documentId"), {
+    insertPageBreak: input.insertPageBreak
+  });
+}
+function insertTable(input, ctx) {
+  const segmentId = optionalText(input.segmentId);
+  const tabId = optionalText(input.tabId);
+  const atEnd = input.insertAtEndOfSegment === true || input.index === void 0;
+  return runSingle(ctx, requireDocumentId(input.documentId, "documentId"), {
+    insertTable: compact({
+      rows: input.rows,
+      columns: input.columns,
+      location: atEnd ? void 0 : compact({ index: input.index, segmentId, tabId }),
+      endOfSegmentLocation: atEnd ? compact({ segmentId, tabId }) : void 0
+    })
+  });
+}
+function insertTableColumn(input, ctx) {
+  return runBatch(ctx, requireDocumentId(input.document_id, "document_id"), input.requests);
+}
+async function insertText(input, ctx) {
+  const documentId = requireDocumentId(input.document_id, "document_id");
+  const text = input.text_to_insert ?? "";
+  const segmentId = optionalText(input.segment_id);
+  const mode = input.append_to_end === true || input.insertion_index === void 0 ? "append" : "index";
+  const output = await runSingle(ctx, documentId, {
+    insertText: compact({
+      text,
+      location: mode === "index" ? compact({ index: input.insertion_index, segmentId }) : void 0,
+      endOfSegmentLocation: mode === "append" ? compact({ segmentId }) : void 0
+    })
+  });
+  return { ...output, insertedTextLength: text.length, mode };
+}
+async function replaceAllText(input, ctx) {
+  const documentId = requireDocumentId(input.document_id, "document_id");
+  const output = await runSingle(ctx, documentId, {
+    replaceAllText: compact({
+      containsText: compact({
+        text: input.find_text,
+        // matchCase 上游给了 false 兜底(Google 的缺省也是 false,写出来是为了让请求自解释)。
+        matchCase: input.match_case ?? false,
+        searchByRegex: input.search_by_regex
+      }),
+      replaceText: input.replace_text,
+      // 空数组不发:发过去等于"在零个 tab 里找",一个都不会替换。
+      tabsCriteria: input.tab_ids !== void 0 && input.tab_ids.length > 0 ? { tabIds: input.tab_ids } : void 0
+    })
+  });
+  return compact({
+    ...output,
+    occurrencesChanged: nestedNumber(output.replies[0], ["replaceAllText", "occurrencesChanged"])
+  });
+}
+function replaceImage(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.document_id, "document_id"), {
+    replaceImage: input.replace_image
+  });
+}
+function unmergeTableCells(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.documentId, "documentId"), {
+    unmergeTableCells: { tableRange: input.tableRange }
+  });
+}
+function updateDocumentBatch(input, ctx) {
+  return runBatch(
+    ctx,
+    requireDocumentId(input.document_id, "document_id"),
+    input.requests,
+    input.write_control
+  );
+}
+async function updateDocumentStyle(input, ctx) {
+  const documentId = requireDocumentId(input.document_id, "document_id");
+  const documentStyle = input.document_style;
+  const fields = optionalText(input.fields) ?? (Object.keys(documentStyle).join(",") || "*");
+  const output = await runSingle(ctx, documentId, {
+    updateDocumentStyle: compact({
+      documentStyle,
+      fields,
+      tabId: optionalText(input.tab_id)
+    })
+  });
+  return { ...output, fields };
+}
+function updateExistingDocument(input, ctx) {
+  return runBatch(ctx, requireDocumentId(input.document_id, "document_id"), input.editDocs);
+}
+function updateTableRowStyle(input, ctx) {
+  return runSingle(ctx, requireDocumentId(input.documentId, "documentId"), {
+    updateTableRowStyle: input.updateTableRowStyle
+  });
+}
+
+// ../plugins/src/googledocs/api/plaintext.ts
+function contentArray(container) {
+  const fields = record(container);
+  if (fields === void 0 || !Array.isArray(fields.content)) return [];
+  return fields.content.flatMap((item) => {
+    const element = record(item);
+    return element === void 0 ? [] : [element];
+  });
+}
+function objectArray2(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((item) => {
+    const element = record(item);
+    return element === void 0 ? [] : [element];
+  });
+}
+function contentText(value) {
+  const content = record(value)?.content;
+  return typeof content === "string" ? content : "";
+}
+function renderParagraph(paragraph) {
+  return objectArray2(paragraph.elements).map((element) => {
+    if (element.textRun !== void 0) return contentText(element.textRun);
+    if (element.autoText !== void 0) return contentText(element.autoText);
+    if (element.pageBreak !== void 0 || element.columnBreak !== void 0) return "\n";
+    return "";
+  }).join("");
+}
+function renderStructuralElements(elements, options) {
+  let output = "";
+  for (const element of elements) {
+    if (element.paragraph !== void 0) {
+      output += renderParagraph(record(element.paragraph) ?? {});
+      continue;
+    }
+    if (element.table !== void 0 && options.includeTables) {
+      const table = objectArray2(record(element.table)?.tableRows).map((row) => objectArray2(row.tableCells).map((cell) => renderStructuralElements(contentArray(cell), options).trim()).join(options.tableCellDelimiter)).join(options.tableRowDelimiter);
+      if (table !== "") output += `${table}
+`;
+      continue;
+    }
+    if (element.tableOfContents !== void 0) {
+      output += renderStructuralElements(contentArray(element.tableOfContents), options);
+    }
+  }
+  return output;
+}
+function renderTabRecursive(tab, options) {
+  const outputs = [];
+  const documentTab = record(tab.documentTab);
+  const title = typeof record(tab.tabProperties)?.title === "string" ? String(record(tab.tabProperties)?.title) : "";
+  const body = documentTab === void 0 ? "" : renderStructuralElements(contentArray(documentTab.body), options).trim();
+  if (body !== "") outputs.push(title === "" ? body : `[Tab: ${title}]
+${body}`);
+  for (const child of objectArray2(tab.childTabs)) outputs.push(...renderTabRecursive(child, options));
+  return outputs;
+}
+function renderTabs(tabs, options) {
+  return objectArray2(tabs).flatMap((tab) => renderTabRecursive(tab, options)).filter((value) => value.trim() !== "").join("\n\n");
+}
+function renderNamedSegments(segments, options) {
+  return Object.entries(segments).map(([segmentId, segment]) => {
+    const text = renderStructuralElements(contentArray(segment), options).trim();
+    return text === "" ? "" : `(${segmentId})
+${text}`;
+  }).filter((value) => value !== "").join("\n\n");
+}
+function renderDocumentPlainText(document, options) {
+  const sections = [];
+  const bodyText = options.includeTabsContent ? renderTabs(document.tabs, options) || renderStructuralElements(contentArray(document.body), options) : renderStructuralElements(contentArray(document.body), options);
+  if (bodyText.trim() !== "") sections.push(bodyText.trimEnd());
+  const headers = record(document.headers);
+  if (options.includeHeaders && headers !== void 0) {
+    const text = renderNamedSegments(headers, options);
+    if (text !== "") sections.push(`[Headers]
+${text}`);
+  }
+  const footers = record(document.footers);
+  if (options.includeFooters && footers !== void 0) {
+    const text = renderNamedSegments(footers, options);
+    if (text !== "") sections.push(`[Footers]
+${text}`);
+  }
+  const footnotes = record(document.footnotes);
+  if (options.includeFootnotes && footnotes !== void 0) {
+    const text = renderNamedSegments(footnotes, options);
+    if (text !== "") sections.push(`[Footnotes]
+${text}`);
+  }
+  return sections.join("\n\n").trim();
+}
+
+// ../plugins/src/googledocs/api/documents.ts
+async function createDocumentResource(ctx, title) {
+  return requestRecord(ctx, { url: `${DOCS_API_BASE}/documents`, method: "POST", body: { title } });
+}
+async function fetchDocument(ctx, documentId, includeTabs) {
+  return requestRecord(ctx, {
+    url: `${DOCS_API_BASE}/documents/${documentId}`,
+    query: includeTabs ? { includeTabsContent: "true" } : void 0
+  });
+}
+async function copyDocument(input, ctx) {
+  const fileId = requireDocumentId(input.document_id, "document_id");
+  const payload = await requestRecord(ctx, {
+    url: `${DRIVE_API_BASE}/files/${fileId}/copy`,
+    method: "POST",
+    query: {
+      // 缺省 true:共享云端硬盘里的文档也能复制,否则 Drive 直接说找不到文件。
+      supportsAllDrives: String(input.include_shared_drives ?? true),
+      fields: DRIVE_FILE_FIELDS
+    },
+    // 不给标题就让 Drive 用它自己的规则("Copy of …"),故这个键可以整个不出现。
+    body: compact({ name: optionalText(input.title) })
+  });
+  return driveFile(payload);
+}
+async function createDocument(input, ctx) {
+  const document = await createDocumentResource(ctx, input.title);
+  const summary = documentSummary(document);
+  const text = optionalText(input.text);
+  if (text === void 0) return { ...summary, insertedTextLength: 0 };
+  await runSingle(ctx, String(summary.documentId), {
+    insertText: { text, endOfSegmentLocation: { segmentId: "" } }
+  });
+  return { ...summary, insertedTextLength: text.length };
+}
+async function createBlankDocument(input, ctx) {
+  return documentSummary(await createDocumentResource(ctx, input.title));
+}
+async function exportDocumentAsPdf(input, ctx) {
+  const fileId = requireFileId(input.file_id, "file_id");
+  const response = await send(ctx, {
+    url: `${DRIVE_API_BASE}/files/${fileId}/export`,
+    query: { mimeType: "application/pdf" }
+  });
+  const bytes = new Uint8Array(await response.arrayBuffer());
+  const filename = optionalText(input.filename);
+  return {
+    fileId,
+    filename: filename === void 0 ? `${fileId}.pdf` : filename.endsWith(".pdf") ? filename : `${filename}.pdf`,
+    mimeType: "application/pdf",
+    dataBase64: base64(bytes),
+    sizeBytes: bytes.byteLength
+  };
+}
+async function getDocumentById(input, ctx) {
+  const documentId = requireDocumentId(input.id, "id");
+  return documentDetail(await fetchDocument(ctx, documentId, input.include_tabs_content === true));
+}
+async function getDocumentPlaintext(input, ctx) {
+  const documentId = requireDocumentId(input.document_id, "document_id");
+  const document = await fetchDocument(ctx, documentId, input.include_tabs_content === true);
+  return {
+    documentId,
+    title: nestedText(document, ["title"]) ?? null,
+    text: renderDocumentPlainText(document, {
+      // 默认值的不对称是上游的(见文件头第 5 条)。
+      includeTables: input.include_tables ?? true,
+      includeHeaders: input.include_headers ?? false,
+      includeFooters: input.include_footers ?? false,
+      includeFootnotes: input.include_footnotes ?? false,
+      includeTabsContent: input.include_tabs_content ?? false,
+      tableCellDelimiter: optionalText(input.table_cell_delimiter) ?? "	",
+      tableRowDelimiter: optionalText(input.table_row_delimiter) ?? "\n"
+    })
+  };
+}
+async function listSpreadsheetCharts(input, ctx) {
+  const spreadsheetId = requireSpreadsheetId(input.spreadsheet_id, "spreadsheet_id");
+  const payload = await requestRecord(ctx, {
+    url: `${SHEETS_API_BASE}/spreadsheets/${spreadsheetId}`,
+    // 字段掩码把响应压到只有图表元数据 —— 不给掩码 Sheets 会回整张表的所有单元格。
+    query: { fields: "spreadsheetId,properties(title),sheets(properties(sheetId,title),charts(chartId,spec,position))" }
+  });
+  return {
+    spreadsheetId,
+    title: nestedText(payload, ["properties", "title"]) ?? null,
+    sheets: objectArray(payload.sheets).map((sheet) => compact({
+      sheetId: nestedNumber(sheet, ["properties", "sheetId"]),
+      title: nestedText(sheet, ["properties", "title"]),
+      charts: objectArray(sheet.charts)
+    }))
+  };
+}
+function driveSearchQuery(query) {
+  if (/[=<>]/u.test(query) || /\b(?:and|or|not)\b/iu.test(query)) return query;
+  return `fullText contains '${query.replace(/'/gu, "\\'")}'`;
+}
+async function searchDocuments(input, ctx) {
+  const includeSharedDrives = String(input.include_shared_drives ?? true);
+  const parts = [
+    // 这一条固定带上:这个 action 只找 Docs 文档,不找别的 Drive 文件。
+    "mimeType='application/vnd.google-apps.document'",
+    input.include_trashed ?? false ? void 0 : "trashed=false",
+    input.starred_only === true ? "starred=true" : void 0,
+    input.shared_with_me === true ? "sharedWithMe=true" : void 0,
+    optionalText(input.created_after) === void 0 ? void 0 : `createdTime > '${input.created_after}'`,
+    optionalText(input.modified_after) === void 0 ? void 0 : `modifiedTime > '${input.modified_after}'`,
+    optionalText(input.query) === void 0 ? void 0 : driveSearchQuery(String(input.query))
+  ].filter((part) => part !== void 0);
+  const payload = await requestRecord(ctx, {
+    url: `${DRIVE_API_BASE}/files`,
+    query: compact({
+      q: parts.join(" and "),
+      orderBy: optionalText(input.order_by),
+      pageToken: optionalText(input.page_token),
+      pageSize: String(input.max_results ?? 10),
+      fields: `nextPageToken,files(${DRIVE_FILE_FIELDS})`,
+      includeItemsFromAllDrives: includeSharedDrives,
+      supportsAllDrives: includeSharedDrives
+    })
+  });
+  return {
+    documents: objectArray(payload.files).map((file) => driveFile(file)),
+    nextPageToken: nestedText(payload, ["nextPageToken"]) ?? null
+  };
+}
+
+// ../plugins/src/googledocs/schema.ts
+var copyDocumentInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document to copy."),
+  title: external_exports.string().describe("The title for the copied document.").optional(),
+  include_shared_drives: external_exports.boolean().describe("Whether to include shared drives when locating the source document.").optional()
+}).describe("The input payload for this action.");
+var copyDocumentOutput = external_exports.looseObject({
+  id: external_exports.string().describe("The ID of the file in Google Drive."),
+  name: external_exports.string().describe("The name of the file."),
+  mimeType: external_exports.string().describe("The MIME type of the file."),
+  webViewLink: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+  createdTime: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+  modifiedTime: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+  driveId: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+  parents: external_exports.array(external_exports.string()).describe("The IDs of the parent folders that contain the file.").optional(),
+  owners: external_exports.array(external_exports.looseObject({
+    displayName: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    emailAddress: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    permissionId: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    photoLink: external_exports.string().describe("A string value that may be null.").nullable().optional()
+  }).describe("Google Drive file owner.")).describe("The owners of the file.").optional(),
+  shared: external_exports.boolean().describe("Whether the file has been shared with others.").optional(),
+  starred: external_exports.boolean().describe("Whether the user has starred the file.").optional(),
+  trashed: external_exports.boolean().describe("Whether the file has been trashed.").optional()
+}).describe("Google Drive file metadata.");
+var createDocumentInput = external_exports.strictObject({
+  title: external_exports.string().describe("The title of the new document."),
+  text: external_exports.string().describe("Initial text to insert at the beginning of the document.").optional()
+}).describe("The input payload for this action.");
+var createDocumentOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  title: external_exports.string().describe("The title of the document."),
+  revisionId: external_exports.string().describe("A string value that may be null.").nullable(),
+  insertedTextLength: external_exports.int().describe("The number of characters inserted as initial text.")
+}).describe("Google Docs action output.");
+var createDocument2Input = external_exports.strictObject({
+  title: external_exports.string().describe("The title of the new document.")
+}).describe("The input payload for this action.");
+var createDocument2Output = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  title: external_exports.string().describe("The title of the document."),
+  revisionId: external_exports.string().describe("A string value that may be null.").nullable().optional()
+}).describe("Google Docs document summary.");
+var createFooterInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  type: external_exports.string().describe("The type of footer to create."),
+  section_break_location: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("The input payload for this action.");
+var createFooterOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var createFootnoteInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  location: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  endOfSegmentLocation: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("The input payload for this action.");
+var createFootnoteOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var createHeaderInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  type: external_exports.string().describe("The type of header to create.").optional(),
+  text: external_exports.string().describe("Initial text to insert into the header.").optional(),
+  sectionBreakLocation: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("The input payload for this action.");
+var createHeaderOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var createNamedRangeInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  name: external_exports.string().min(1).max(256).describe("The name of the named range."),
+  rangeStartIndex: external_exports.int().describe("The zero-based start index of the range."),
+  rangeEndIndex: external_exports.int().describe("The zero-based end index of the range."),
+  rangeSegmentId: external_exports.string().describe("The ID of the segment the range belongs to.").optional()
+}).describe("The input payload for this action.");
+var createNamedRangeOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var createParagraphBulletsInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  createParagraphBullets: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var createParagraphBulletsOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteContentRangeInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  range: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var deleteContentRangeOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteFooterInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  footer_id: external_exports.string().describe("The ID of the footer to delete."),
+  tab_id: external_exports.string().describe("The ID of the tab containing the footer.").optional()
+}).describe("The input payload for this action.");
+var deleteFooterOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteHeaderInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  header_id: external_exports.string().describe("The ID of the header to delete."),
+  tab_id: external_exports.string().describe("The ID of the tab containing the header.").optional()
+}).describe("The input payload for this action.");
+var deleteHeaderOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteNamedRangeInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  deleteNamedRange: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var deleteNamedRangeOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteParagraphBulletsInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  range: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys."),
+  tab_id: external_exports.string().describe("The ID of the tab containing the range.").optional()
+}).describe("The input payload for this action.");
+var deleteParagraphBulletsOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteTableColumnInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  requests: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).min(1).describe("DeleteTableColumnRequest objects.")
+}).describe("The input payload for this action.");
+var deleteTableColumnOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var deleteTableRowInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  tableCellLocation: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var deleteTableRowOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var exportDocumentAsPdfInput = external_exports.strictObject({
+  file_id: external_exports.string().describe("The ID of the Google Docs file to export."),
+  filename: external_exports.string().describe("The filename for the exported PDF.").optional()
+}).describe("The input payload for this action.");
+var exportDocumentAsPdfOutput = external_exports.looseObject({
+  fileId: external_exports.string().describe("The ID of the exported file in Google Drive."),
+  filename: external_exports.string().describe("The filename used for the exported PDF."),
+  mimeType: external_exports.literal("application/pdf").describe("The MIME type of the exported file."),
+  dataBase64: external_exports.string().describe("The Base64-encoded binary content of the exported PDF."),
+  sizeBytes: external_exports.int().describe("The size of the exported PDF in bytes.")
+}).describe("Google Docs action output.");
+var getDocumentByIdInput = external_exports.strictObject({
+  id: external_exports.string().describe("The ID of the Google Docs document to retrieve."),
+  include_tabs_content: external_exports.boolean().describe("Whether to populate the tabs field in the response.").optional()
+}).describe("The input payload for this action.");
+var getDocumentByIdOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  title: external_exports.string().describe("The title of the document."),
+  revisionId: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+  body: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  headers: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  footers: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  footnotes: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  tabs: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects.").optional(),
+  documentStyle: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  namedRanges: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  inlineObjects: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional(),
+  lists: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs document detail.");
+var getDocumentPlaintextInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  include_tables: external_exports.boolean().describe("Whether to include table content.").optional(),
+  include_footers: external_exports.boolean().describe("Whether to include footer content.").optional(),
+  include_headers: external_exports.boolean().describe("Whether to include header content.").optional(),
+  include_footnotes: external_exports.boolean().describe("Whether to include footnote content.").optional(),
+  include_tabs_content: external_exports.boolean().describe("Whether to include content from all tabs.").optional(),
+  table_row_delimiter: external_exports.string().describe("The delimiter to insert between table rows.").optional(),
+  table_cell_delimiter: external_exports.string().describe("The delimiter to insert between table cells.").optional()
+}).describe("The input payload for this action.");
+var getDocumentPlaintextOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  title: external_exports.string().describe("A string value that may be null.").nullable(),
+  text: external_exports.string().describe("The plain-text rendering of the document content.")
+}).describe("Google Docs action output.");
+var insertInlineImageInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  uri: external_exports.url().describe("The publicly accessible URI of the image to insert."),
+  location: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys."),
+  objectSize: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("The input payload for this action.");
+var insertInlineImageOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var insertPageBreakInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  insertPageBreak: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var insertPageBreakOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var insertTableActionInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  rows: external_exports.int().gt(0).describe("The number of rows in the table to insert."),
+  columns: external_exports.int().gt(0).describe("The number of columns in the table to insert."),
+  index: external_exports.int().describe("The zero-based index at which to insert the table.").optional(),
+  segmentId: external_exports.string().describe("The segment ID.").optional(),
+  tabId: external_exports.string().describe("The tab ID.").optional(),
+  insertAtEndOfSegment: external_exports.boolean().describe("Whether to insert at the end of the segment.").optional()
+}).describe("The input payload for this action.");
+var insertTableActionOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var insertTableColumnInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  requests: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).min(1).describe("InsertTableColumnRequest objects.")
+}).describe("The input payload for this action.");
+var insertTableColumnOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var insertTextActionInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  text_to_insert: external_exports.string().describe("The text to insert.").optional(),
+  append_to_end: external_exports.boolean().describe("Whether to append the text to the end.").optional(),
+  insertion_index: external_exports.int().describe("The zero-based index at which to insert the text.").optional(),
+  segment_id: external_exports.string().describe("The segment ID.").optional()
+}).describe("The input payload for this action.");
+var insertTextActionOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var listSpreadsheetChartsInput = external_exports.strictObject({
+  spreadsheet_id: external_exports.string().describe("The ID of the Google Sheets spreadsheet.")
+}).describe("The input payload for this action.");
+var listSpreadsheetChartsOutput = external_exports.looseObject({
+  spreadsheetId: external_exports.string().describe("The ID of the Google Sheets spreadsheet."),
+  title: external_exports.string().describe("A string value that may be null.").nullable(),
+  sheets: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("The sheets in the spreadsheet, each with their chart metadata.")
+}).describe("Google Docs action output.");
+var replaceAllTextInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  find_text: external_exports.string().describe("The text or pattern to search for."),
+  replace_text: external_exports.string().describe("The replacement text."),
+  match_case: external_exports.boolean().describe("Whether the search should be case-sensitive.").optional(),
+  search_by_regex: external_exports.boolean().describe("Whether to treat find_text as a regular expression.").optional(),
+  tab_ids: external_exports.array(external_exports.string()).describe("The IDs of specific tabs to search.").optional()
+}).describe("The input payload for this action.");
+var replaceAllTextOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var replaceImageInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  replace_image: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var replaceImageOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var searchDocumentsInput = external_exports.strictObject({
+  query: external_exports.string().describe("A Google Drive query string or full-text search string.").optional(),
+  order_by: external_exports.string().describe("A comma-separated list of fields to sort results by.").optional(),
+  page_token: external_exports.string().describe("A page token from a previous search response.").optional(),
+  max_results: external_exports.int().min(1).max(100).describe("The maximum number of files to return.").optional(),
+  starred_only: external_exports.boolean().describe("Whether to return only starred files.").optional(),
+  created_after: external_exports.iso.datetime({ offset: true }).describe("Only files created after this time are returned.").optional(),
+  modified_after: external_exports.iso.datetime({ offset: true }).describe("Only files modified after this time are returned.").optional(),
+  shared_with_me: external_exports.boolean().describe("Whether to return only files shared directly with the user.").optional(),
+  include_trashed: external_exports.boolean().describe("Whether to include trashed files.").optional(),
+  include_shared_drives: external_exports.boolean().describe("Whether to include files from shared drives.").optional()
+}).describe("The input payload for this action.");
+var searchDocumentsOutput = external_exports.looseObject({
+  documents: external_exports.array(external_exports.looseObject({
+    id: external_exports.string().describe("The ID of the file in Google Drive."),
+    name: external_exports.string().describe("The name of the file."),
+    mimeType: external_exports.string().describe("The MIME type of the file."),
+    webViewLink: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    createdTime: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    modifiedTime: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    driveId: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+    parents: external_exports.array(external_exports.string()).describe("The IDs of the parent folders that contain the file.").optional(),
+    owners: external_exports.array(external_exports.looseObject({
+      displayName: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+      emailAddress: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+      permissionId: external_exports.string().describe("A string value that may be null.").nullable().optional(),
+      photoLink: external_exports.string().describe("A string value that may be null.").nullable().optional()
+    }).describe("Google Drive file owner.")).describe("The owners of the file.").optional(),
+    shared: external_exports.boolean().describe("Whether the file has been shared with others.").optional(),
+    starred: external_exports.boolean().describe("Whether the user has starred the file.").optional(),
+    trashed: external_exports.boolean().describe("Whether the file has been trashed.").optional()
+  }).describe("Google Drive file metadata.")).describe("The list of matching Google Docs files."),
+  nextPageToken: external_exports.string().describe("A string value that may be null.").nullable()
+}).describe("Google Docs action output.");
+var unmergeTableCellsInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  tableRange: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var unmergeTableCellsOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var updateDocumentBatchInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  requests: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).min(1).describe("Docs API Request objects."),
+  write_control: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("The input payload for this action.");
+var updateDocumentBatchOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var updateDocumentStyleInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  document_style: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys."),
+  fields: external_exports.string().describe("A field mask specifying which style properties to update.").optional(),
+  tab_id: external_exports.string().describe("The ID of the tab whose document style should be updated.").optional()
+}).describe("The input payload for this action.");
+var updateDocumentStyleOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var updateExistingDocumentInput = external_exports.strictObject({
+  document_id: external_exports.string().describe("The ID of the Google Docs document."),
+  editDocs: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).min(1).describe("Docs API Request objects describing the edits.")
+}).describe("The input payload for this action.");
+var updateExistingDocumentOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var updateTableRowStyleInput = external_exports.strictObject({
+  documentId: external_exports.string().describe("The ID of the Google Docs document."),
+  updateTableRowStyle: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")
+}).describe("The input payload for this action.");
+var updateTableRowStyleOutput = external_exports.looseObject({
+  documentId: external_exports.string().describe("The ID of the document that was updated."),
+  replies: external_exports.array(external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.")).describe("An array of JSON-like objects."),
+  writeControl: external_exports.looseObject({}).describe("A JSON-like object with arbitrary string keys.").optional()
+}).describe("Google Docs batch update result.");
+var googledocsActions = {
+  copy_document: {
+    description: "Copy an existing Google Docs document through Google Drive.",
+    effect: "write",
+    inputSchema: copyDocumentInput,
+    outputSchema: external_exports.toJSONSchema(copyDocumentOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_document: {
+    description: "Create a Google Docs document and optionally insert initial text at the beginning.",
+    effect: "write",
+    inputSchema: createDocumentInput,
+    outputSchema: external_exports.toJSONSchema(createDocumentOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_document2: {
+    description: "Create a blank Google Docs document.",
+    effect: "write",
+    inputSchema: createDocument2Input,
+    outputSchema: external_exports.toJSONSchema(createDocument2Output, { io: "output", unrepresentable: "any" })
+  },
+  create_footer: {
+    description: "Create a footer in a Google Docs document.",
+    effect: "write",
+    inputSchema: createFooterInput,
+    outputSchema: external_exports.toJSONSchema(createFooterOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_footnote: {
+    description: "Create a footnote in a Google Docs document.",
+    effect: "write",
+    inputSchema: createFootnoteInput,
+    outputSchema: external_exports.toJSONSchema(createFootnoteOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_header: {
+    description: "Create a header in a Google Docs document and optionally insert initial text.",
+    effect: "write",
+    inputSchema: createHeaderInput,
+    outputSchema: external_exports.toJSONSchema(createHeaderOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_named_range: {
+    description: "Create a named range over a specific span in a Google Docs document.",
+    effect: "write",
+    inputSchema: createNamedRangeInput,
+    outputSchema: external_exports.toJSONSchema(createNamedRangeOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_paragraph_bullets: {
+    description: "Add bullets to paragraphs within a specified range in a Google Docs document.",
+    effect: "write",
+    inputSchema: createParagraphBulletsInput,
+    outputSchema: external_exports.toJSONSchema(createParagraphBulletsOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_content_range: {
+    description: "Delete a content range from a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteContentRangeInput,
+    outputSchema: external_exports.toJSONSchema(deleteContentRangeOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_footer: {
+    description: "Delete a footer from a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteFooterInput,
+    outputSchema: external_exports.toJSONSchema(deleteFooterOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_header: {
+    description: "Delete a header from a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteHeaderInput,
+    outputSchema: external_exports.toJSONSchema(deleteHeaderOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_named_range: {
+    description: "Delete a named range from a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteNamedRangeInput,
+    outputSchema: external_exports.toJSONSchema(deleteNamedRangeOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_paragraph_bullets: {
+    description: "Remove bullets from paragraphs within a specified range in a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteParagraphBulletsInput,
+    outputSchema: external_exports.toJSONSchema(deleteParagraphBulletsOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_table_column: {
+    description: "Delete one or more table columns from a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteTableColumnInput,
+    outputSchema: external_exports.toJSONSchema(deleteTableColumnOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_table_row: {
+    description: "Delete a table row from a Google Docs document.",
+    effect: "destructive",
+    inputSchema: deleteTableRowInput,
+    outputSchema: external_exports.toJSONSchema(deleteTableRowOutput, { io: "output", unrepresentable: "any" })
+  },
+  export_document_as_pdf: {
+    description: "Export a Google Docs file as a PDF through Google Drive.",
+    effect: "read",
+    inputSchema: exportDocumentAsPdfInput,
+    outputSchema: external_exports.toJSONSchema(exportDocumentAsPdfOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_document_by_id: {
+    description: "Retrieve a Google Docs document by ID.",
+    effect: "read",
+    inputSchema: getDocumentByIdInput,
+    outputSchema: external_exports.toJSONSchema(getDocumentByIdOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_document_plaintext: {
+    description: "Retrieve a Google Docs document and render it as best-effort plain text.",
+    effect: "read",
+    inputSchema: getDocumentPlaintextInput,
+    outputSchema: external_exports.toJSONSchema(getDocumentPlaintextOutput, { io: "output", unrepresentable: "any" })
+  },
+  insert_inline_image: {
+    description: "Insert an inline image from a URI at a specified location.",
+    effect: "write",
+    inputSchema: insertInlineImageInput,
+    outputSchema: external_exports.toJSONSchema(insertInlineImageOutput, { io: "output", unrepresentable: "any" })
+  },
+  insert_page_break: {
+    description: "Insert a page break at a specified location.",
+    effect: "write",
+    inputSchema: insertPageBreakInput,
+    outputSchema: external_exports.toJSONSchema(insertPageBreakOutput, { io: "output", unrepresentable: "any" })
+  },
+  insert_table_action: {
+    description: "Insert a table at a specific index or at the end of a segment.",
+    effect: "write",
+    inputSchema: insertTableActionInput,
+    outputSchema: external_exports.toJSONSchema(insertTableActionOutput, { io: "output", unrepresentable: "any" })
+  },
+  insert_table_column: {
+    description: "Insert one or more table columns at a specified location.",
+    effect: "write",
+    inputSchema: insertTableColumnInput,
+    outputSchema: external_exports.toJSONSchema(insertTableColumnOutput, { io: "output", unrepresentable: "any" })
+  },
+  insert_text_action: {
+    description: "Insert text at a specific index or append it to the end.",
+    effect: "write",
+    inputSchema: insertTextActionInput,
+    outputSchema: external_exports.toJSONSchema(insertTextActionOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_spreadsheet_charts: {
+    description: "List chart metadata from a Google Sheets spreadsheet.",
+    effect: "read",
+    inputSchema: listSpreadsheetChartsInput,
+    outputSchema: external_exports.toJSONSchema(listSpreadsheetChartsOutput, { io: "output", unrepresentable: "any" })
+  },
+  replace_all_text: {
+    description: "Replace all matching text in a Google Docs document.",
+    effect: "write",
+    inputSchema: replaceAllTextInput,
+    outputSchema: external_exports.toJSONSchema(replaceAllTextOutput, { io: "output", unrepresentable: "any" })
+  },
+  replace_image: {
+    description: "Replace an existing image in a Google Docs document with a new image from a URI.",
+    effect: "write",
+    inputSchema: replaceImageInput,
+    outputSchema: external_exports.toJSONSchema(replaceImageOutput, { io: "output", unrepresentable: "any" })
+  },
+  search_documents: {
+    description: "Search Google Docs files with Google Drive filters.",
+    effect: "read",
+    inputSchema: searchDocumentsInput,
+    outputSchema: external_exports.toJSONSchema(searchDocumentsOutput, { io: "output", unrepresentable: "any" })
+  },
+  unmerge_table_cells: {
+    description: "Unmerge previously merged table cells in a Google Docs document.",
+    effect: "write",
+    inputSchema: unmergeTableCellsInput,
+    outputSchema: external_exports.toJSONSchema(unmergeTableCellsOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_document_batch: {
+    description: "Apply raw Docs batchUpdate requests to a Google Docs document.",
+    effect: "write",
+    inputSchema: updateDocumentBatchInput,
+    outputSchema: external_exports.toJSONSchema(updateDocumentBatchOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_document_style: {
+    description: "Update global document style settings.",
+    effect: "write",
+    inputSchema: updateDocumentStyleInput,
+    outputSchema: external_exports.toJSONSchema(updateDocumentStyleOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_existing_document: {
+    description: "Apply one or more programmatic edits to an existing Google Docs document.",
+    effect: "write",
+    inputSchema: updateExistingDocumentInput,
+    outputSchema: external_exports.toJSONSchema(updateExistingDocumentOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_table_row_style: {
+    description: "Update the style of a table row in a Google Docs document.",
+    effect: "write",
+    inputSchema: updateTableRowStyleInput,
+    outputSchema: external_exports.toJSONSchema(updateTableRowStyleOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/googledocs/index.ts
+function createGoogledocsPlugin() {
+  return createProviderPlugin({
+    description: "Google Docs",
+    oauth: {
+      authorizationUrl: "https://accounts.google.com/o/oauth2/v2/auth",
+      tokenUrl: "https://oauth2.googleapis.com/token",
+      scopes: [
+        "https://www.googleapis.com/auth/documents.readonly",
+        "https://www.googleapis.com/auth/documents",
+        "https://www.googleapis.com/auth/drive.file",
+        "https://www.googleapis.com/auth/spreadsheets.readonly"
+      ],
+      clientAuth: "client_secret_post",
+      authorizationParams: {
+        access_type: "offline",
+        prompt: "consent"
+      }
+    },
+    actions: googledocsActions,
+    handlers: {
+      copy_document: copyDocument,
+      create_document: createDocument,
+      create_document2: createBlankDocument,
+      create_footer: createFooter,
+      create_footnote: createFootnote,
+      create_header: createHeader,
+      create_named_range: createNamedRange,
+      create_paragraph_bullets: createParagraphBullets,
+      delete_content_range: deleteContentRange,
+      delete_footer: deleteFooter,
+      delete_header: deleteHeader,
+      delete_named_range: deleteNamedRange,
+      delete_paragraph_bullets: deleteParagraphBullets,
+      delete_table_column: deleteTableColumn,
+      delete_table_row: deleteTableRow,
+      export_document_as_pdf: exportDocumentAsPdf,
+      get_document_by_id: getDocumentById,
+      get_document_plaintext: getDocumentPlaintext,
+      insert_inline_image: insertInlineImage,
+      insert_page_break: insertPageBreak,
+      insert_table_action: insertTable,
+      insert_table_column: insertTableColumn,
+      insert_text_action: insertText,
+      list_spreadsheet_charts: listSpreadsheetCharts,
+      replace_all_text: replaceAllText,
+      replace_image: replaceImage,
+      search_documents: searchDocuments,
+      unmerge_table_cells: unmergeTableCells,
+      update_document_batch: updateDocumentBatch,
+      update_document_style: updateDocumentStyle,
+      update_existing_document: updateExistingDocument,
+      update_table_row_style: updateTableRowStyle
+    }
+  });
+}
+var googledocs_default = createGoogledocsPlugin();
+export {
+  createGoogledocsPlugin,
+  googledocs_default as default
+};