mcpscraper-sdk 0.31.1 → 0.33.0

package/README.md

@@ -45,7 +45,7 @@ Current Google search pricing is 60 Credits per SERP search and 400 Credits plus
 
 ## API surface
 
-`client.tools` is the generated, typed 315-tool MCP surface. It includes 214 MCP Scraper tools and all 101 mirrored Memory tools from `contracts/mcp.tools.json`. Those output types come from the versioned complete server build manifest; the compact live MCP `tools/list` response intentionally omits output schemas and is not a code-generation source.
+`client.tools` is the generated, typed 331-tool MCP surface. It includes 230 MCP Scraper tools and all 101 mirrored Memory tools from `contracts/mcp.tools.json`. Those output types come from the versioned complete server build manifest; the compact live MCP `tools/list` response intentionally omits output schemas and is not a code-generation source.
 
 For multimodal results such as `meta_ad_creative_media`, call `client.tools.callToolResult(...)` to preserve native MCP image/audio/resource blocks. `callTool(...)` remains backward-compatible and returns the parsed structured or text value.
 
@@ -89,7 +89,7 @@ Integrations are included with an active Starter plan or higher: OAuth connect/r
 
 Core operations are flat on the client: `searchSerp`, `harvestPaa`, `extractUrl`, `mapSiteUrls`, `extractSite`, `auditSite`, `getExtractSiteStatus`, `readExtractSiteExport`, `readExtractSiteImage`, `listJobs`, `getJob`, `getHistory`, `getLedger`.
 
-Everything else is namespaced by product area, matching the OpenAPI spec's tags: `client.youtube`, `client.screenshot`, `client.facebook`, `client.googleAds`, `client.instagram`, `client.reddit`, `client.video`, `client.maps`, `client.directory`, `client.serpIntelligence`, `client.workflows`.
+Everything else is namespaced by product area, matching the OpenAPI spec's tags: `client.youtube`, `client.screenshot`, `client.facebook`, `client.googleAds`, `client.instagram`, `client.reddit`, `client.video`, `client.maps`, `client.directory`, `client.serpIntelligence`, `client.workflows`, `client.gmail`. The REST Gmail namespace preserves opaque path handles and requires explicit idempotency keys for mutations; the generated `client.tools.connections.gmail*` methods expose the exact MCP input/output contracts.
 
 ### Retry-safe SERP Intelligence captures
 
@@ -137,4 +137,4 @@ npm run generate
 
 ## See also
 
-[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 114-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)
+[Repo README](../../README.md) (including complete Gmail and reversible bulk examples) · [`mcpscraper-memory-sdk`](../memory) (Node, full 116-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)

package/dist/index.cjs

@@ -407,11 +407,48 @@ var WorkflowsNamespace = class {
     return this.r.call("POST", `/workflows/schedules/${encodeURIComponent(id)}/run`);
   }
 };
+var GmailNamespace = class {
+  constructor(r) {
+    this.r = r;
+  }
+  r;
+  searchMessages(params) {
+    return this.r.call("POST", "/api/gmail/messages/search", params);
+  }
+  getMessage(messageId, params) {
+    return this.r.call("POST", `/api/gmail/messages/${encodeURIComponent(messageId)}`, params);
+  }
+  getAttachment(params) {
+    return this.r.call("POST", "/api/gmail/attachments/get", params);
+  }
+  prepareSelection(params) {
+    return this.r.call("POST", "/api/gmail/selections", params);
+  }
+  exportSelection(selectionId, params) {
+    return this.r.call("POST", `/api/gmail/selections/${encodeURIComponent(selectionId)}/export`, params);
+  }
+  bulkManage(selectionId, params, options) {
+    return this.r.call("POST", `/api/gmail/selections/${encodeURIComponent(selectionId)}/manage`, params, { "Idempotency-Key": options.idempotencyKey });
+  }
+  bulkDelete(selectionId, params, options) {
+    return this.r.call("POST", `/api/gmail/selections/${encodeURIComponent(selectionId)}/delete`, params, { "Idempotency-Key": options.idempotencyKey });
+  }
+  prepareMemoryImport(params) {
+    return this.r.call("POST", "/api/gmail/imports/prepare", params);
+  }
+  importToMemory(importPlanId, options) {
+    return this.r.call("POST", `/api/gmail/imports/${encodeURIComponent(importPlanId)}/start`, void 0, { "Idempotency-Key": options.idempotencyKey });
+  }
+  importStatus(ingestId) {
+    return this.r.call("GET", `/api/gmail/imports/${encodeURIComponent(ingestId)}`);
+  }
+};
 var MemoryTools = class {
   access;
   capture;
   channels;
   facts;
+  files;
   graph;
   library;
   memory;
@@ -428,6 +465,7 @@ var MemoryTools = class {
     this.capture = new import_mcpscraper_memory_sdk.CaptureNamespace(callTool);
     this.channels = new import_mcpscraper_memory_sdk.ChannelsNamespace(callTool);
     this.facts = new import_mcpscraper_memory_sdk.FactsNamespace(callTool);
+    this.files = new import_mcpscraper_memory_sdk.FilesNamespace(callTool);
     this.graph = new import_mcpscraper_memory_sdk.GraphNamespace(callTool);
     this.library = new import_mcpscraper_memory_sdk.LibraryNamespace(callTool);
     this.memory = new import_mcpscraper_memory_sdk.MemoryNamespace(callTool);
@@ -454,6 +492,7 @@ var ScraperClient = class {
   directory;
   serpIntelligence;
   workflows;
+  gmail;
   memoryTools;
   tools;
   constructor(options) {
@@ -471,6 +510,7 @@ var ScraperClient = class {
     this.directory = new DirectoryNamespace(this.r);
     this.serpIntelligence = new SerpIntelligenceNamespace(this.r);
     this.workflows = new WorkflowsNamespace(this.r);
+    this.gmail = new GmailNamespace(this.r);
     this.memoryTools = new MemoryTools(this.callMemoryTool.bind(this));
     this.tools = new import_mcpscraper_memory_sdk.McpToolsClient({
       apiKey: options.apiKey,