terra-mcp-google 0.1.11

package/dist/services/drive/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/services/drive/adapter.ts"],"names":[],"mappings":"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"}

package/dist/services/drive/tools.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import type { drive_v3 } from "googleapis";
+import { type ToolResult } from "../../core/result.js";
+import { type ArgsOf, type ToolRegistration } from "../../core/tool.js";
+declare const listFilesInput: {
+    query: z.ZodOptional<z.ZodString>;
+    page_size: z.ZodDefault<z.ZodNumber>;
+    page_token: z.ZodOptional<z.ZodString>;
+    order_by: z.ZodOptional<z.ZodString>;
+    include_trashed: z.ZodDefault<z.ZodBoolean>;
+    response_format: z.ZodDefault<z.ZodEnum<{
+        markdown: "markdown";
+        json: "json";
+    }>>;
+};
+export declare function driveListFiles(drive: drive_v3.Drive, args: ArgsOf<typeof listFilesInput>): Promise<ToolResult>;
+declare const getFileInput: {
+    file_id: z.ZodString;
+    response_format: z.ZodDefault<z.ZodEnum<{
+        markdown: "markdown";
+        json: "json";
+    }>>;
+};
+export declare function driveGetFile(drive: drive_v3.Drive, args: ArgsOf<typeof getFileInput>): Promise<ToolResult>;
+declare const downloadFileInput: {
+    file_id: z.ZodString;
+    export_mime_type: z.ZodOptional<z.ZodString>;
+    save_path: z.ZodOptional<z.ZodString>;
+};
+export declare function driveDownloadFile(drive: drive_v3.Drive, args: ArgsOf<typeof downloadFileInput>): Promise<ToolResult>;
+declare const createFolderInput: {
+    name: z.ZodString;
+    parent_id: z.ZodOptional<z.ZodString>;
+};
+export declare function driveCreateFolder(drive: drive_v3.Drive, args: ArgsOf<typeof createFolderInput>): Promise<ToolResult>;
+declare const uploadFileInput: {
+    name: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    local_path: z.ZodOptional<z.ZodString>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+};
+export declare function driveUploadFile(drive: drive_v3.Drive, args: ArgsOf<typeof uploadFileInput>): Promise<ToolResult>;
+declare const updateFileInput: {
+    file_id: z.ZodString;
+    new_name: z.ZodOptional<z.ZodString>;
+    add_parents: z.ZodOptional<z.ZodString>;
+    remove_parents: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    mime_type: z.ZodOptional<z.ZodString>;
+};
+export declare function driveUpdateFile(drive: drive_v3.Drive, args: ArgsOf<typeof updateFileInput>): Promise<ToolResult>;
+declare const copyFileInput: {
+    file_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+};
+export declare function driveCopyFile(drive: drive_v3.Drive, args: ArgsOf<typeof copyFileInput>): Promise<ToolResult>;
+declare const deleteFileInput: {
+    file_id: z.ZodString;
+    permanent: z.ZodDefault<z.ZodBoolean>;
+};
+export declare function driveDeleteFile(drive: drive_v3.Drive, args: ArgsOf<typeof deleteFileInput>): Promise<ToolResult>;
+export declare const driveTools: readonly ToolRegistration[];
+export {};

package/dist/services/drive/tools.js

@@ -0,0 +1,324 @@
+import { z } from "zod";
+import { DriveFileAdapter } from "./adapter.js";
+import { errorResult, formatResponse, responseFormatSchema, toolResult, } from "../../core/result.js";
+import { driveTool } from "../../core/tool.js";
+// ── Markdown rendering ────────────────────────────────────────────────────────
+function formatFileMarkdown(f) {
+    const lines = [`## ${f.name ?? "(untitled)"} (${f.id})`];
+    lines.push(`- **Type**: ${f.mimeType ?? "unknown"}`);
+    if (f.size)
+        lines.push(`- **Size**: ${f.size} bytes`);
+    if (f.modifiedTime)
+        lines.push(`- **Modified**: ${f.modifiedTime}`);
+    if (f.owners?.length) {
+        lines.push(`- **Owner**: ${f.owners.map((o) => o.displayName ?? o.emailAddress).join(", ")}`);
+    }
+    if (f.trashed)
+        lines.push(`- **Trashed**: yes`);
+    if (f.webViewLink)
+        lines.push(`- **Link**: ${f.webViewLink}`);
+    return lines.join("\n");
+}
+function renderFiles(files, format, header, extra = {}) {
+    return formatResponse(format, { ...extra, count: files.length, files }, () => {
+        if (!files.length)
+            return `${header}\n\n(no files)`;
+        return [`# ${header}`, "", ...files.map(formatFileMarkdown)].join("\n\n");
+    });
+}
+// ── Tools ─────────────────────────────────────────────────────────────────────
+// Each tool: input schema → exported pure handler (unit-tested directly) →
+// registration. The handler's arg type derives from the schema, so the schema
+// is the single source of truth.
+const listFilesInput = {
+    query: z.string().optional().describe("Drive 'q' search expression"),
+    page_size: z.number().int().min(1).max(100).default(25),
+    page_token: z.string().optional(),
+    order_by: z.string().optional().describe("e.g. 'modifiedTime desc'"),
+    include_trashed: z.boolean().default(false),
+    response_format: responseFormatSchema,
+};
+export async function driveListFiles(drive, args) {
+    const result = await new DriveFileAdapter(drive).listFiles({
+        query: args.query,
+        pageSize: args.page_size,
+        pageToken: args.page_token,
+        orderBy: args.order_by,
+        includeTrashed: args.include_trashed,
+    });
+    const output = {
+        count: result.files.length,
+        files: result.files,
+        next_page_token: result.nextPageToken,
+    };
+    const text = renderFiles(result.files, args.response_format, `Drive files (${result.files.length})`, {
+        next_page_token: result.nextPageToken,
+    });
+    return toolResult(text, output);
+}
+const listFilesTool = driveTool({
+    name: "drive_list_files",
+    title: "List / search Drive files",
+    description: `List or search files and folders in Google Drive.
+
+Args:
+  - query (string, optional): Drive search query (the 'q' parameter). Examples:
+      name contains 'budget'
+      mimeType = 'application/vnd.google-apps.spreadsheet'
+      '<folderId>' in parents
+      fullText contains 'quarterly report'
+      modifiedTime > '2024-01-01T00:00:00'
+    Combine with 'and'/'or'. Omit to list recent files.
+  - page_size (number 1-100, default 25)
+  - page_token (string, optional): from a previous response's next_page_token
+  - order_by (string, optional): e.g. 'modifiedTime desc', 'name'
+  - include_trashed (boolean, default false)
+  - response_format ('markdown'|'json', default markdown)
+
+Returns: { count, files:[{id,name,mimeType,modifiedTime,size,parents,webViewLink,owners}], next_page_token }`,
+    inputSchema: listFilesInput,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    run: driveListFiles,
+});
+const getFileInput = {
+    file_id: z.string().min(1).describe("Drive file ID"),
+    response_format: responseFormatSchema,
+};
+export async function driveGetFile(drive, args) {
+    const file = await new DriveFileAdapter(drive).getFile(args.file_id);
+    const text = formatResponse(args.response_format, file, () => formatFileMarkdown(file));
+    return toolResult(text, { file });
+}
+const getFileTool = driveTool({
+    name: "drive_get_file",
+    title: "Get Drive file metadata",
+    description: `Get metadata for a single Drive file or folder by ID.
+
+Args:
+  - file_id (string): the Drive file ID
+  - response_format ('markdown'|'json', default markdown)
+
+Returns: { file: {id,name,mimeType,size,modifiedTime,parents,owners,webViewLink,...} }`,
+    inputSchema: getFileInput,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    run: driveGetFile,
+});
+const downloadFileInput = {
+    file_id: z.string().min(1),
+    export_mime_type: z.string().optional(),
+    save_path: z
+        .string()
+        .optional()
+        .describe("Path under TERRA_MCP_LOCAL_FILE_ROOT to write the downloaded bytes"),
+};
+export async function driveDownloadFile(drive, args) {
+    const download = await new DriveFileAdapter(drive).downloadFile({
+        fileId: args.file_id,
+        exportMimeType: args.export_mime_type,
+        savePath: args.save_path,
+    });
+    if (download.savedTo) {
+        return toolResult(`Downloaded "${download.name}" (${download.bytes} bytes, ${download.mimeType}) to ${download.savedTo}`, { file_id: args.file_id, saved_to: download.savedTo, bytes: download.bytes, mime_type: download.mimeType });
+    }
+    if (download.binaryRequiresSavePath) {
+        return errorResult(`Error: "${download.name}" is binary (${download.mimeType}). Provide save_path to write it to disk, ` +
+            `or set export_mime_type to a text format (e.g. text/csv, text/plain) for Google files.`);
+    }
+    return toolResult(download.content ?? "", {
+        file_id: args.file_id,
+        name: download.name,
+        mime_type: download.mimeType,
+        content: download.content,
+    });
+}
+const downloadFileTool = driveTool({
+    name: "drive_download_file",
+    title: "Download / export Drive file",
+    description: `Download a file's content. Google-native files (Docs/Sheets/Slides) are exported.
+
+Args:
+  - file_id (string)
+  - export_mime_type (string, optional): for Google-native files, e.g. 'text/csv', 'text/plain',
+    'application/pdf', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'.
+    Defaults: Sheets→text/csv, Docs→text/plain, Slides→application/pdf.
+  - save_path (string, optional): write bytes under TERRA_MCP_LOCAL_FILE_ROOT. Required for
+    binary content; if omitted, only text content is returned inline.
+
+Returns (text content inline) or { file_id, saved_to, bytes, mime_type } when saved to disk.`,
+    inputSchema: downloadFileInput,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    run: driveDownloadFile,
+});
+const createFolderInput = {
+    name: z.string().min(1),
+    parent_id: z.string().optional(),
+};
+export async function driveCreateFolder(drive, args) {
+    const file = await new DriveFileAdapter(drive).createFolder({
+        name: args.name,
+        parentId: args.parent_id,
+    });
+    return toolResult(`Created folder "${file.name}" (${file.id})`, { file });
+}
+const createFolderTool = driveTool({
+    name: "drive_create_folder",
+    title: "Create Drive folder",
+    description: `Create a new folder in Drive.
+
+Args:
+  - name (string)
+  - parent_id (string, optional): parent folder ID; omit for My Drive root
+
+Returns: { file: {id, name, ...} }`,
+    inputSchema: createFolderInput,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    run: driveCreateFolder,
+});
+const uploadFileInput = {
+    name: z.string().min(1),
+    content: z.string().optional(),
+    local_path: z.string().optional(),
+    mime_type: z.string().optional(),
+    parent_id: z.string().optional(),
+};
+export async function driveUploadFile(drive, args) {
+    if (!args.content && !args.local_path) {
+        return errorResult("Error: provide either 'content' (inline text) or 'local_path' to upload.");
+    }
+    const file = await new DriveFileAdapter(drive).uploadFile({
+        name: args.name,
+        content: args.content,
+        localPath: args.local_path,
+        mimeType: args.mime_type,
+        parentId: args.parent_id,
+    });
+    return toolResult(`Uploaded "${file.name}" (${file.id})`, { file });
+}
+const uploadFileTool = driveTool({
+    name: "drive_upload_file",
+    title: "Upload file to Drive",
+    description: `Create a new Drive file from inline text or a local file path.
+
+Args:
+  - name (string): file name to create
+  - content (string, optional): inline text content
+  - local_path (string, optional): path under TERRA_MCP_LOCAL_FILE_ROOT to upload (takes precedence)
+  - mime_type (string, optional): e.g. 'text/plain', 'text/csv', 'application/pdf' (default octet-stream)
+  - parent_id (string, optional): destination folder ID
+
+Provide exactly one of content/local_path. Returns: { file: {id, name, ...} }`,
+    inputSchema: uploadFileInput,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    run: driveUploadFile,
+});
+const updateFileInput = {
+    file_id: z.string().min(1),
+    new_name: z.string().optional(),
+    add_parents: z.string().optional(),
+    remove_parents: z.string().optional(),
+    content: z.string().optional(),
+    mime_type: z.string().optional(),
+};
+export async function driveUpdateFile(drive, args) {
+    const file = await new DriveFileAdapter(drive).updateFile({
+        fileId: args.file_id,
+        newName: args.new_name,
+        addParents: args.add_parents,
+        removeParents: args.remove_parents,
+        content: args.content,
+        mimeType: args.mime_type,
+    });
+    return toolResult(`Updated "${file.name}" (${file.id})`, { file });
+}
+const updateFileTool = driveTool({
+    name: "drive_update_file",
+    title: "Update / rename / move Drive file",
+    description: `Rename, move, and/or replace the content of an existing Drive file.
+
+Args:
+  - file_id (string)
+  - new_name (string, optional): rename
+  - add_parents (string, optional): comma-separated folder IDs to add (move into)
+  - remove_parents (string, optional): comma-separated folder IDs to remove
+  - content (string, optional): replace file content with this text
+  - mime_type (string, optional): MIME for replaced content (default text/plain)
+
+Returns: { file: {id, name, ...} }`,
+    inputSchema: updateFileInput,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    run: driveUpdateFile,
+});
+const copyFileInput = {
+    file_id: z.string().min(1),
+    name: z.string().optional(),
+    parent_id: z.string().optional(),
+};
+export async function driveCopyFile(drive, args) {
+    const file = await new DriveFileAdapter(drive).copyFile({
+        fileId: args.file_id,
+        name: args.name,
+        parentId: args.parent_id,
+    });
+    return toolResult(`Copied to "${file.name}" (${file.id})`, { file });
+}
+const copyFileTool = driveTool({
+    name: "drive_copy_file",
+    title: "Copy Drive file",
+    description: `Duplicate a Drive file.
+
+Args:
+  - file_id (string): source file
+  - name (string, optional): name for the copy
+  - parent_id (string, optional): destination folder
+
+Returns: { file: {id, name, ...} } of the new copy`,
+    inputSchema: copyFileInput,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    run: driveCopyFile,
+});
+const deleteFileInput = {
+    file_id: z.string().min(1),
+    permanent: z.boolean().default(false).describe("Irreversibly delete instead of trashing"),
+};
+export async function driveDeleteFile(drive, args) {
+    const files = new DriveFileAdapter(drive);
+    if (args.permanent) {
+        await files.deleteFile(args.file_id);
+        return toolResult(`Permanently deleted file ${args.file_id}.`, {
+            file_id: args.file_id,
+            permanent: true,
+        });
+    }
+    const file = await files.trashFile(args.file_id);
+    return toolResult(`Moved "${file.name}" (${file.id}) to trash (recoverable).`, {
+        file_id: args.file_id,
+        permanent: false,
+        trashed: file.trashed,
+    });
+}
+const deleteFileTool = driveTool({
+    name: "drive_delete_file",
+    title: "Delete / trash Drive file",
+    description: `Move a Drive file to trash (default, recoverable) or delete it permanently.
+
+Args:
+  - file_id (string)
+  - permanent (boolean, default false): true = permanent, irreversible delete
+
+Returns: { file_id, permanent, trashed? }`,
+    inputSchema: deleteFileInput,
+    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+    run: driveDeleteFile,
+});
+// ── Registration ────────────────────────────────────────────────────────────
+export const driveTools = [
+    listFilesTool,
+    getFileTool,
+    downloadFileTool,
+    createFolderTool,
+    uploadFileTool,
+    updateFileTool,
+    copyFileTool,
+    deleteFileTool,
+];
+//# sourceMappingURL=tools.js.map

package/dist/services/drive/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/services/drive/tools.ts"],"names":[],"mappings":"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"}

package/dist/services/registry.d.ts

@@ -0,0 +1,24 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistration } from "../core/tool.js";
+/** Every Google tool exposed by this server, in registration order. */
+export declare const googleTools: readonly ToolRegistration[];
+/**
+ * The tools exposed for a given safety + scope level.
+ *
+ * - Safe mode keeps only the read-only tools; every mutating tool (create/write/
+ *   delete) is dropped so a client can browse but never change anything.
+ * - `grantedScopes`, when provided, drops a service's tools entirely unless its
+ *   OAuth scope was granted at login — so a Sheets-only grant exposes no
+ *   `drive_*` tools. `undefined` means "scope unknown" (e.g. not signed in yet)
+ *   and keeps every tool. The `google_*` auth tools are never scope-gated.
+ *
+ * @see isReadOnlyTool
+ */
+export declare function selectGoogleTools(safeMode: boolean, grantedScopes?: readonly string[]): readonly ToolRegistration[];
+/** Read-only tool names — the only ones enabled in safe mode (registration order). */
+export declare const READ_ONLY_TOOL_NAMES: readonly string[];
+/** Mutating ("dangerous") tool names — disabled in safe mode (registration order). */
+export declare const DANGEROUS_TOOL_NAMES: readonly string[];
+export declare function registerGoogleTools(server: McpServer, options?: {
+    safeMode?: boolean;
+}): Promise<void>;

package/dist/services/registry.js

@@ -0,0 +1,57 @@
+import { authTools } from "./auth/tools.js";
+import { isReadOnlyTool, registerAll } from "../core/tool.js";
+import { driveTools } from "./drive/tools.js";
+import { sheetsTools } from "./sheets/tools.js";
+import { DRIVE_SCOPE, SHEETS_SCOPE } from "../config/constants.js";
+import { getAuthStatus } from "../google/auth.js";
+/** Every Google tool exposed by this server, in registration order. */
+export const googleTools = [...authTools, ...driveTools, ...sheetsTools];
+/** Tools whose API scope must have been granted at login before they work. */
+const SCOPED_TOOLS = [
+    { scope: DRIVE_SCOPE, tools: driveTools },
+    { scope: SHEETS_SCOPE, tools: sheetsTools },
+];
+/**
+ * The tools exposed for a given safety + scope level.
+ *
+ * - Safe mode keeps only the read-only tools; every mutating tool (create/write/
+ *   delete) is dropped so a client can browse but never change anything.
+ * - `grantedScopes`, when provided, drops a service's tools entirely unless its
+ *   OAuth scope was granted at login — so a Sheets-only grant exposes no
+ *   `drive_*` tools. `undefined` means "scope unknown" (e.g. not signed in yet)
+ *   and keeps every tool. The `google_*` auth tools are never scope-gated.
+ *
+ * @see isReadOnlyTool
+ */
+export function selectGoogleTools(safeMode, grantedScopes) {
+    let tools = googleTools;
+    if (grantedScopes) {
+        const granted = new Set(grantedScopes);
+        const ungranted = new Set(SCOPED_TOOLS.filter((s) => !granted.has(s.scope)).flatMap((s) => s.tools));
+        tools = tools.filter((t) => !ungranted.has(t));
+    }
+    return safeMode ? tools.filter(isReadOnlyTool) : tools;
+}
+/** Read-only tool names — the only ones enabled in safe mode (registration order). */
+export const READ_ONLY_TOOL_NAMES = googleTools
+    .filter(isReadOnlyTool)
+    .map((t) => t.toolName);
+/** Mutating ("dangerous") tool names — disabled in safe mode (registration order). */
+export const DANGEROUS_TOOL_NAMES = googleTools
+    .filter((t) => !isReadOnlyTool(t))
+    .map((t) => t.toolName);
+export async function registerGoogleTools(server, options = {}) {
+    // Honor the scopes the user actually granted at login. If not signed in yet,
+    // we can't know the grant, so register everything (calls fail later if a
+    // scope is missing). Best-effort: a status lookup failure falls back to all.
+    let grantedScopes;
+    try {
+        const status = await getAuthStatus();
+        grantedScopes = status.authenticated ? (status.scopes ?? undefined) : undefined;
+    }
+    catch {
+        grantedScopes = undefined;
+    }
+    registerAll(server, selectGoogleTools(options.safeMode ?? false, grantedScopes));
+}
+//# sourceMappingURL=registry.js.map

package/dist/services/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/services/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAyB,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAgC,CAAC,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,WAAW,CAAC,CAAC;AAEtG,8EAA8E;AAC9E,MAAM,YAAY,GAAyE;IACzF,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE;IACzC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE;CAC5C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiB,EACjB,aAAiC;IAEjC,IAAI,KAAK,GAAG,WAAW,CAAC;IACxB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAC1E,CAAC;QACF,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAsB,WAAW;KAC/D,MAAM,CAAC,cAAc,CAAC;KACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE1B,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAsB,WAAW;KAC/D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;KACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,UAAkC,EAAE;IAEpC,6EAA6E;IAC7E,yEAAyE;IACzE,6EAA6E;IAC7E,IAAI,aAA4C,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QACrC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,SAAS,CAAC;IAC5B,CAAC;IACD,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/services/sheets/adapter.d.ts

@@ -0,0 +1,112 @@
+import type { sheets_v4 } from "googleapis";
+/** A single spreadsheet cell value as exchanged with the Sheets API. */
+export type CellValue = string | number | boolean | null;
+export interface SheetTab {
+    sheetId?: number | null;
+    title?: string | null;
+    index?: number | null;
+    rows?: number | null;
+    columns?: number | null;
+}
+export interface SpreadsheetSummary {
+    spreadsheetId?: string | null;
+    title?: string | null;
+    sheets: SheetTab[];
+}
+export interface RangeValues {
+    range?: string | null;
+    values: CellValue[][];
+}
+export interface WriteResult {
+    updatedRange?: string | null;
+    updatedRows?: number | null;
+    updatedColumns?: number | null;
+    updatedCells?: number | null;
+}
+export interface AppendResult {
+    tableRange?: string | null;
+    updatedRange?: string | null;
+    updatedRows?: number | null;
+    updatedCells?: number | null;
+}
+export interface BatchWriteResult {
+    totalUpdatedRows?: number | null;
+    totalUpdatedColumns?: number | null;
+    totalUpdatedCells?: number | null;
+    responses: WriteResult[];
+}
+/**
+ * Anti-corruption layer over the Sheets v4 API: every Google call lives here so
+ * tool handlers deal in plain, intention-revealing shapes. Mirrors
+ * {@link ../drive/adapter.DriveFileAdapter} so both services read the same way.
+ */
+export declare class SheetsAdapter {
+    private readonly sheets;
+    constructor(sheets: sheets_v4.Sheets);
+    createSpreadsheet(args: {
+        title: string;
+        sheetTitles?: string[];
+    }): Promise<SpreadsheetSummary>;
+    getSpreadsheet(spreadsheetId: string): Promise<SpreadsheetSummary>;
+    readRange(args: {
+        spreadsheetId: string;
+        range: string;
+        valueRenderOption: string;
+    }): Promise<RangeValues>;
+    readRanges(args: {
+        spreadsheetId: string;
+        ranges: string[];
+        valueRenderOption: string;
+    }): Promise<RangeValues[]>;
+    writeRange(args: {
+        spreadsheetId: string;
+        range: string;
+        values: CellValue[][];
+        valueInputOption: string;
+    }): Promise<WriteResult>;
+    batchWriteRanges(args: {
+        spreadsheetId: string;
+        data: {
+            range: string;
+            values: CellValue[][];
+        }[];
+        valueInputOption: string;
+    }): Promise<BatchWriteResult>;
+    appendRows(args: {
+        spreadsheetId: string;
+        range: string;
+        values: CellValue[][];
+        valueInputOption: string;
+        insertDataOption: string;
+    }): Promise<AppendResult>;
+    clearRange(args: {
+        spreadsheetId: string;
+        range: string;
+    }): Promise<string | null | undefined>;
+    addSheet(args: {
+        spreadsheetId: string;
+        title: string;
+        rows?: number;
+        columns?: number;
+    }): Promise<SheetTab>;
+    deleteSheet(args: {
+        spreadsheetId: string;
+        sheetId: number;
+    }): Promise<void>;
+    repeatCellFormat(args: {
+        spreadsheetId: string;
+        range: sheets_v4.Schema$GridRange;
+        format: sheets_v4.Schema$CellFormat;
+        fields: string;
+    }): Promise<void>;
+    setDataValidation(args: {
+        spreadsheetId: string;
+        range: sheets_v4.Schema$GridRange;
+        rule: sheets_v4.Schema$DataValidationRule;
+    }): Promise<void>;
+    /** Escape hatch: send raw batchUpdate requests straight through to the API. */
+    batchUpdate(args: {
+        spreadsheetId: string;
+        requests: Record<string, unknown>[];
+    }): Promise<sheets_v4.Schema$Response[]>;
+}