mcp-scraper 0.66.0 → 0.66.1

package/dist/bin/api-server.cjs

@@ -46,7 +46,7 @@ var init_harvest_timeout = __esm({
   "src/harvest-timeout.ts"() {
     "use strict";
     SCRAPE_FUNCTION_MAX_MS = 8e5;
-    DEFAULT_TOOL_CLIENT_TIMEOUT_MS = 3e5;
+    DEFAULT_TOOL_CLIENT_TIMEOUT_MS = 59e4;
     CLIENT_OVER_SERVER_MARGIN_MS = 15e3;
   }
 });
@@ -186,8 +186,9 @@ function publicErrorMessage(code) {
     case "proxy_unavailable":
       return "The web request could not establish a working connection. Please retry later.";
     case "harvest_timeout":
-    case "mcp_request_timeout":
       return "The request timed out before it completed. Please retry with a smaller request.";
+    case "mcp_request_timeout":
+      return "The MCP caller stopped waiting before a final response arrived. Durable work may still be running; continue with the returned Task or job handle instead of restarting it.";
     case "concurrency_limit_exceeded":
       return "The service is available, but this account has reached its parallel-operation limit. Wait for an active operation to finish or add capacity.";
     case "unauthorized":
@@ -50536,7 +50537,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.66.0";
+    PACKAGE_VERSION = "0.66.1";
   }
 });
 
@@ -55717,7 +55718,7 @@ function decodeTaskHandle(taskId, secret2, ownerId2) {
       decipher.update(ciphertext),
       decipher.final()
     ]).toString("utf8"));
-    if (parsed.v !== 1 || parsed.ownerId !== ownerId2 || !["site_export", "directory_workflow", "video_frame_analysis", "lead_list_enrichment"].includes(String(parsed.kind)) || typeof parsed.operationId !== "string" || !parsed.operationId || typeof parsed.createdAtMs !== "number" || typeof parsed.expiresAtMs !== "number") throw new Error("invalid payload");
+    if (parsed.v !== 1 || parsed.ownerId !== ownerId2 || !["paa_harvest", "site_export", "directory_workflow", "video_frame_analysis", "lead_list_enrichment"].includes(String(parsed.kind)) || typeof parsed.operationId !== "string" || !parsed.operationId || typeof parsed.createdAtMs !== "number" || typeof parsed.expiresAtMs !== "number") throw new Error("invalid payload");
     if (Date.now() > parsed.expiresAtMs) {
       throw new import_server.ProtocolError(TASK_INVALID_PARAMS, "Failed to retrieve task: Task has expired");
     }
@@ -55730,9 +55731,25 @@ function decodeTaskHandle(taskId, secret2, ownerId2) {
 function objectValue(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
-function taskSeed(kind, result) {
+function resultValue(result) {
   const structured = objectValue(result.structuredContent);
+  if (structured) return structured;
+  const block = result.content.find((item) => item.type === "text");
+  if (!block || block.type !== "text") return void 0;
+  try {
+    return objectValue(JSON.parse(block.text));
+  } catch {
+    return void 0;
+  }
+}
+function taskSeed(kind, result) {
+  const structured = resultValue(result);
   if (!structured || result.isError === true) return void 0;
+  if (kind === "paa_harvest") {
+    const operationId2 = structured.job_id ?? structured.jobId;
+    if (typeof operationId2 !== "string" || !["pending", "running"].includes(String(structured.status))) return void 0;
+    return { kind, operationId: operationId2, statusMessage: "PAA harvest started. Progress will be preserved while the client polls this Task." };
+  }
   if (kind === "site_export") {
     const operationId2 = structured.jobId;
     if (typeof operationId2 !== "string" || structured.status !== "pending") return void 0;
@@ -55763,10 +55780,13 @@ function taskBase(payload, taskId) {
   };
 }
 function statusFrom(result) {
-  const status = objectValue(result.structuredContent)?.status;
+  const status = resultValue(result)?.status;
   return typeof status === "string" ? status : void 0;
 }
 async function pollTask(executor, payload) {
+  if (payload.kind === "paa_harvest") {
+    return executor.harvestPaaStatus({ jobId: payload.operationId });
+  }
   if (payload.kind === "site_export") {
     return executor.checkSiteExport({ jobId: payload.operationId });
   }
@@ -55778,6 +55798,30 @@ async function pollTask(executor, payload) {
   }
   return executor.videoFrameAnalysisStatus({ runId: payload.operationId });
 }
+function taskProgressMessage(kind, result, status) {
+  const value = resultValue(result) ?? {};
+  if (kind === "paa_harvest") {
+    const resultRecord = objectValue(value.result) ?? {};
+    const progress = objectValue(resultRecord.progress) ?? {};
+    const records = Array.isArray(progress.records) ? progress.records.length : 0;
+    const attempts = Array.isArray(value.attempts) ? value.attempts.length : 0;
+    const pieces = [records > 0 ? `${records} questions preserved` : null, attempts > 0 ? `${attempts} attempts recorded` : null].filter(Boolean);
+    return pieces.length > 0 ? `PAA harvest is ${status ?? "running"}: ${pieces.join(", ")}.` : `PAA harvest is ${status ?? "running"}; no question checkpoint has been persisted yet.`;
+  }
+  if (kind === "lead_list_enrichment") {
+    const progress = objectValue(value.progress) ?? {};
+    const completed = typeof progress.completedRows === "number" ? progress.completedRows : null;
+    const total = typeof progress.totalRows === "number" ? progress.totalRows : null;
+    if (completed !== null && total !== null) return `Lead list enrichment is ${status ?? "running"}: ${completed}/${total} rows completed.`;
+  }
+  if (kind === "directory_workflow") {
+    const progress = objectValue(value.progress) ?? {};
+    const completed = typeof progress.completedCities === "number" ? progress.completedCities : null;
+    const total = typeof progress.totalCities === "number" ? progress.totalCities : null;
+    if (completed !== null && total !== null) return `Directory workflow is ${status ?? "running"}: ${completed}/${total} markets completed.`;
+  }
+  return status ? `Underlying operation status: ${status}.` : "Underlying operation is running.";
+}
 async function cancelTask(executor, payload) {
   if (payload.kind !== "lead_list_enrichment") return;
   const result = await executor.leadListEnrichCancel({ jobId: payload.operationId });
@@ -55794,7 +55838,7 @@ async function detailedTask(executor, taskId, options) {
     return {
       ...base,
       status: "working",
-      statusMessage: status ? `Underlying operation status: ${status}.` : "Underlying operation is running."
+      statusMessage: taskProgressMessage(payload.kind, result, status)
     };
   }
   if (payload.kind === "lead_list_enrichment" && status === "failed") {
@@ -55805,6 +55849,22 @@ async function detailedTask(executor, taskId, options) {
       result
     };
   }
+  if (payload.kind === "paa_harvest" && status === "failed") {
+    return {
+      ...base,
+      status: "failed",
+      statusMessage: "PAA harvest failed; persisted attempts and billing state are included in the result.",
+      result
+    };
+  }
+  if (payload.kind === "paa_harvest" && status === "cancelled") {
+    return {
+      ...base,
+      status: "cancelled",
+      statusMessage: "PAA harvest was cancelled.",
+      result
+    };
+  }
   if (payload.kind === "lead_list_enrichment" && status === "cancelled") {
     return {
       ...base,
@@ -55821,6 +55881,7 @@ async function detailedTask(executor, taskId, options) {
   };
 }
 function isWorking(kind, status) {
+  if (kind === "paa_harvest") return status === "pending" || status === "running";
   if (kind === "site_export") return status === "pending" || status === "running";
   if (kind === "directory_workflow") return status === "queued" || status === "running";
   if (kind === "lead_list_enrichment") return status === "queued" || status === "running";
@@ -55852,6 +55913,9 @@ function registerMcpTasksExtension(server, executor, options) {
     return {};
   });
   return {
+    supportsTasks() {
+      return hasTasksCapability(server.server.getClientCapabilities());
+    },
     taskify(kind, result) {
       if (!hasTasksCapability(server.server.getClientCapabilities())) return result;
       const seed = taskSeed(kind, result);
@@ -56408,7 +56472,12 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
     inputSchema: harvestPaaInputSchema,
     outputSchema: recordOutputSchema("harvest_paa", HarvestPaaOutputSchema),
     annotations: liveWebToolAnnotations("Google PAA + SERP Harvest")
-  }, async (input) => formatHarvestPaa(await executor.harvestPaa(input), input));
+  }, async (input, requestContext) => {
+    if (tasks.supportsTasks()) {
+      return tasks.taskify("paa_harvest", await executor.startHarvestPaa(input), requestContext);
+    }
+    return formatHarvestPaa(await executor.harvestPaa(input), input);
+  });
   server.registerTool("search_serp", {
     title: "Google SERP Lookup",
     description: `Google SERP lookup without PAA expansion. Defaults to organic rankings and Google entity IDs; request local pack, forums, videos, AI surfaces, and What People Are Saying with individual include flags or includeAllSerpFeatures at the same product price. Use gl for country and location only when city or regional context matters. Costs ${SERP_SEARCH_CREDITS} Credits per search. Call credits_info for current pricing and balance.`,
@@ -57409,7 +57478,7 @@ var init_http_mcp_tool_executor = __esm({
                   retryable: true,
                   path: path6,
                   timeoutMs,
-                  message: `MCP Scraper request exceeded ${Math.round(timeoutMs / 1e3)}s and was cancelled client-side. The operation may still be running or may have already completed and been billed on our side. Retry with fewer results or use the async API for deep harvests. ${timeoutGuidance}`
+                  message: `MCP Scraper stopped waiting after ${Math.round(timeoutMs / 1e3)}s. This does not prove server-side work stopped: the operation may still be running or may have already completed and been billed. Prefer the returned Task or job handle for long work. ${timeoutGuidance}`
                 })
               }],
               isError: true
@@ -57495,6 +57564,13 @@ var init_http_mcp_tool_executor = __esm({
         const headers = input.idempotencyKey ? { "Idempotency-Key": input.idempotencyKey } : {};
         return this.call("/harvest/sync", input, timeoutMs, "POST", headers, true);
       }
+      startHarvestPaa(input) {
+        const headers = input.idempotencyKey ? { "Idempotency-Key": input.idempotencyKey } : {};
+        return this.call("/harvest", input, this.timeoutMs, "POST", headers, true);
+      }
+      harvestPaaStatus(input) {
+        return this.getJson(`/jobs/${encodeURIComponent(input.jobId)}`);
+      }
       searchSerp(input) {
         const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(0, true).clientMs;
         const headers = input.idempotencyKey ? { "Idempotency-Key": input.idempotencyKey } : {};
@@ -59727,6 +59803,1539 @@ var init_browser_agent_mcp_server = __esm({
   }
 });
 
+// src/mcp/memory-image-tool-schemas.generated.ts
+var MEMORY_IMAGE_TOOL_SCHEMAS;
+var init_memory_image_tool_schemas_generated = __esm({
+  "src/mcp/memory-image-tool-schemas.generated.ts"() {
+    "use strict";
+    MEMORY_IMAGE_TOOL_SCHEMAS = [
+      {
+        "id": "image_project_create",
+        "upstreamName": "image_project_create",
+        "description": "Create a stable image project inside a writable hosted Memory vault. Projects organize governed private image assets; they do not create local folders or change object keys.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string",
+              "description": "Writable logical Memory vault. Defaults to the active vault."
+            },
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120
+            },
+            "description": {
+              "type": "string",
+              "maxLength": 2e3
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "project": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "name",
+                "description",
+                "createdAt"
+              ],
+              "additionalProperties": false
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Create Image Project",
+          "readOnlyHint": false,
+          "destructiveHint": false,
+          "idempotentHint": false,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_project_list",
+        "upstreamName": "image_project_list",
+        "description": "List image projects in an accessible hosted Memory vault. Returns organization metadata only, never object-store keys.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "projects": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "status": {
+                    "type": "string"
+                  },
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "updatedAt": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name",
+                  "description",
+                  "status",
+                  "createdAt",
+                  "updatedAt"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "List Image Projects",
+          "readOnlyHint": true,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_folder_create",
+        "upstreamName": "image_folder_create",
+        "description": "Create a nested image folder inside one writable Memory image project. Maximum nesting depth is eight; this changes logical organization only.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "projectId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "parentId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120
+            }
+          },
+          "required": [
+            "projectId",
+            "name"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "folder": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "projectId": {
+                  "type": "string"
+                },
+                "parentId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": "string"
+                },
+                "depth": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "projectId",
+                "parentId",
+                "name",
+                "depth",
+                "createdAt"
+              ],
+              "additionalProperties": false
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Create Image Folder",
+          "readOnlyHint": false,
+          "destructiveHint": false,
+          "idempotentHint": false,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_folder_list",
+        "upstreamName": "image_folder_list",
+        "description": "List the bounded folder tree for one accessible Memory image project.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "projectId": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": [
+            "projectId"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "folders": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "projectId": {
+                    "type": "string"
+                  },
+                  "parentId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "depth": {
+                    "type": "number"
+                  },
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "updatedAt": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "projectId",
+                  "parentId",
+                  "name",
+                  "depth",
+                  "createdAt",
+                  "updatedAt"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "List Image Folders",
+          "readOnlyHint": true,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_asset_save",
+        "upstreamName": "image_asset_save",
+        "description": "Opt in to preserving one image in hosted Memory. Saves immutable private bytes, creates a sanitized preview, consumes storage/embedding quota, and queues visual plus useful fused embeddings. Use for durable image recall; do not use merely to view a transient scrape result.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "projectId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "folderId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "sourceUrl": {
+              "type": "string",
+              "format": "uri",
+              "description": "Public HTTPS image URL. Private-network and redirect targets are rejected."
+            },
+            "artifactId": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Owned MCP Scraper artifact ID. Available through the aggregate MCP handoff."
+            },
+            "imageBase64": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Bounded base64 image for clients without an upload transport; maximum decoded size is 20 MiB."
+            },
+            "title": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 240
+            },
+            "description": {
+              "type": "string",
+              "maxLength": 4e3
+            },
+            "altText": {
+              "type": "string",
+              "maxLength": 2e3
+            },
+            "tags": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 80
+              },
+              "maxItems": 20
+            },
+            "sourceRef": {
+              "type": "object",
+              "additionalProperties": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "maxLength": 1e3
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "idempotencyKey": {
+              "type": "string",
+              "minLength": 8,
+              "maxLength": 200,
+              "description": "Stable key for this logical save. Retrying the same request returns the same asset without another write."
+            }
+          },
+          "required": [
+            "title",
+            "idempotencyKey"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "asset": {
+              "type": "object",
+              "properties": {
+                "assetId": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "altText": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "sourceUrl": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "sourceKind": {
+                  "type": "string"
+                },
+                "mimeType": {
+                  "type": "string"
+                },
+                "bytes": {
+                  "type": "number"
+                },
+                "width": {
+                  "type": "number"
+                },
+                "height": {
+                  "type": "number"
+                },
+                "projectId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "folderId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "status": {
+                  "type": "string"
+                },
+                "embeddingStatus": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "updatedAt": {
+                  "type": "string"
+                },
+                "preview": {
+                  "type": "object",
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    "expiresAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "const": "image/webp"
+                    }
+                  },
+                  "required": [
+                    "url",
+                    "expiresAt",
+                    "mimeType"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "assetId",
+                "title",
+                "description",
+                "altText",
+                "sourceUrl",
+                "sourceKind",
+                "mimeType",
+                "bytes",
+                "width",
+                "height",
+                "projectId",
+                "folderId",
+                "tags",
+                "status",
+                "embeddingStatus",
+                "createdAt",
+                "updatedAt"
+              ],
+              "additionalProperties": false
+            },
+            "reusedObject": {
+              "type": "boolean"
+            },
+            "nextAction": {
+              "type": "string"
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Save Image Asset",
+          "readOnlyHint": false,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": true
+        }
+      },
+      {
+        "id": "image_asset_get",
+        "upstreamName": "image_asset_get",
+        "description": "Read one authorized private image asset and optionally mint a five-minute preview URL. The URL is never persisted; call again after expiry.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "assetId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "includePreview": {
+              "type": "boolean",
+              "default": true
+            }
+          },
+          "required": [
+            "assetId"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "asset": {
+              "type": "object",
+              "properties": {
+                "assetId": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "altText": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "sourceUrl": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "sourceKind": {
+                  "type": "string"
+                },
+                "mimeType": {
+                  "type": "string"
+                },
+                "bytes": {
+                  "type": "number"
+                },
+                "width": {
+                  "type": "number"
+                },
+                "height": {
+                  "type": "number"
+                },
+                "projectId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "folderId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "status": {
+                  "type": "string"
+                },
+                "embeddingStatus": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "updatedAt": {
+                  "type": "string"
+                },
+                "preview": {
+                  "type": "object",
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    "expiresAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "const": "image/webp"
+                    }
+                  },
+                  "required": [
+                    "url",
+                    "expiresAt",
+                    "mimeType"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "assetId",
+                "title",
+                "description",
+                "altText",
+                "sourceUrl",
+                "sourceKind",
+                "mimeType",
+                "bytes",
+                "width",
+                "height",
+                "projectId",
+                "folderId",
+                "tags",
+                "status",
+                "embeddingStatus",
+                "createdAt",
+                "updatedAt"
+              ],
+              "additionalProperties": false
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Get Image Asset",
+          "readOnlyHint": true,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_asset_list",
+        "upstreamName": "image_asset_list",
+        "description": "List authorized private image metadata with exact location, provenance, media, tag, and creation-time filters. Use image_asset_search for semantic retrieval.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "projectId": {
+              "type": "string"
+            },
+            "folderId": {
+              "type": "string"
+            },
+            "sourceKind": {
+              "type": "string",
+              "enum": [
+                "upload",
+                "scrape",
+                "screenshot",
+                "instagram",
+                "external_url",
+                "import"
+              ]
+            },
+            "sourceHost": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 253
+            },
+            "mimeType": {
+              "type": "string",
+              "enum": [
+                "image/jpeg",
+                "image/png",
+                "image/webp",
+                "image/gif"
+              ]
+            },
+            "tags": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 80
+              },
+              "maxItems": 20
+            },
+            "createdAfter": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "createdBefore": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "limit": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 30
+            }
+          },
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "assets": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "assetId": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "altText": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "sourceUrl": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "sourceKind": {
+                    "type": "string"
+                  },
+                  "mimeType": {
+                    "type": "string"
+                  },
+                  "bytes": {
+                    "type": "number"
+                  },
+                  "width": {
+                    "type": "number"
+                  },
+                  "height": {
+                    "type": "number"
+                  },
+                  "projectId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "folderId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "tags": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "status": {
+                    "type": "string"
+                  },
+                  "embeddingStatus": {
+                    "type": "string"
+                  },
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "updatedAt": {
+                    "type": "string"
+                  },
+                  "preview": {
+                    "type": "object",
+                    "properties": {
+                      "url": {
+                        "type": "string",
+                        "format": "uri"
+                      },
+                      "expiresAt": {
+                        "type": "string",
+                        "format": "date-time"
+                      },
+                      "mimeType": {
+                        "type": "string",
+                        "const": "image/webp"
+                      }
+                    },
+                    "required": [
+                      "url",
+                      "expiresAt",
+                      "mimeType"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "assetId",
+                  "title",
+                  "description",
+                  "altText",
+                  "sourceUrl",
+                  "sourceKind",
+                  "mimeType",
+                  "bytes",
+                  "width",
+                  "height",
+                  "projectId",
+                  "folderId",
+                  "tags",
+                  "status",
+                  "embeddingStatus",
+                  "createdAt",
+                  "updatedAt"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "count": {
+              "type": "number"
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "List Image Assets",
+          "readOnlyHint": true,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_asset_search",
+        "upstreamName": "image_asset_search",
+        "description": "Semantically search authorized private image Memory using text, a stored asset, a public HTTPS image, or bounded base64. Text plus one image performs a fused query. This consumes query-embedding usage.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "queryText": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4e3
+            },
+            "queryAssetId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "queryUrl": {
+              "type": "string",
+              "format": "uri"
+            },
+            "queryImageBase64": {
+              "type": "string",
+              "minLength": 1
+            },
+            "projectId": {
+              "type": "string"
+            },
+            "folderId": {
+              "type": "string"
+            },
+            "sourceKind": {
+              "type": "string",
+              "enum": [
+                "upload",
+                "scrape",
+                "screenshot",
+                "instagram",
+                "external_url",
+                "import"
+              ]
+            },
+            "sourceHost": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 253
+            },
+            "mimeType": {
+              "type": "string",
+              "enum": [
+                "image/jpeg",
+                "image/png",
+                "image/webp",
+                "image/gif"
+              ]
+            },
+            "tags": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 80
+              },
+              "maxItems": 20
+            },
+            "createdAfter": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "createdBefore": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "limit": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 30,
+              "default": 10
+            },
+            "includePreview": {
+              "type": "boolean",
+              "default": false
+            }
+          },
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "results": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "asset": {
+                    "type": "object",
+                    "properties": {
+                      "assetId": {
+                        "type": "string"
+                      },
+                      "title": {
+                        "type": "string"
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "altText": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "sourceUrl": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "sourceKind": {
+                        "type": "string"
+                      },
+                      "mimeType": {
+                        "type": "string"
+                      },
+                      "bytes": {
+                        "type": "number"
+                      },
+                      "width": {
+                        "type": "number"
+                      },
+                      "height": {
+                        "type": "number"
+                      },
+                      "projectId": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "folderId": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "tags": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "status": {
+                        "type": "string"
+                      },
+                      "embeddingStatus": {
+                        "type": "string"
+                      },
+                      "createdAt": {
+                        "type": "string"
+                      },
+                      "updatedAt": {
+                        "type": "string"
+                      },
+                      "preview": {
+                        "type": "object",
+                        "properties": {
+                          "url": {
+                            "type": "string",
+                            "format": "uri"
+                          },
+                          "expiresAt": {
+                            "type": "string",
+                            "format": "date-time"
+                          },
+                          "mimeType": {
+                            "type": "string",
+                            "const": "image/webp"
+                          }
+                        },
+                        "required": [
+                          "url",
+                          "expiresAt",
+                          "mimeType"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "required": [
+                      "assetId",
+                      "title",
+                      "description",
+                      "altText",
+                      "sourceUrl",
+                      "sourceKind",
+                      "mimeType",
+                      "bytes",
+                      "width",
+                      "height",
+                      "projectId",
+                      "folderId",
+                      "tags",
+                      "status",
+                      "embeddingStatus",
+                      "createdAt",
+                      "updatedAt"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "score": {
+                    "type": "number"
+                  },
+                  "matchRepresentations": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "enum": [
+                        "visual",
+                        "fused"
+                      ]
+                    }
+                  },
+                  "embeddingModel": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "asset",
+                  "score",
+                  "matchRepresentations",
+                  "embeddingModel"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "count": {
+              "type": "number"
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Search Image Assets",
+          "readOnlyHint": true,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": true
+        }
+      },
+      {
+        "id": "image_asset_move",
+        "upstreamName": "image_asset_move",
+        "description": "Move an image asset between project/folder locations in the same writable Memory vault. This updates metadata only and never copies private image bytes.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "assetId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "projectId": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "folderId": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "assetId"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "asset": {
+              "type": "object",
+              "properties": {
+                "assetId": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "altText": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "sourceUrl": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "sourceKind": {
+                  "type": "string"
+                },
+                "mimeType": {
+                  "type": "string"
+                },
+                "bytes": {
+                  "type": "number"
+                },
+                "width": {
+                  "type": "number"
+                },
+                "height": {
+                  "type": "number"
+                },
+                "projectId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "folderId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "status": {
+                  "type": "string"
+                },
+                "embeddingStatus": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "updatedAt": {
+                  "type": "string"
+                },
+                "preview": {
+                  "type": "object",
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    "expiresAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "const": "image/webp"
+                    }
+                  },
+                  "required": [
+                    "url",
+                    "expiresAt",
+                    "mimeType"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "assetId",
+                "title",
+                "description",
+                "altText",
+                "sourceUrl",
+                "sourceKind",
+                "mimeType",
+                "bytes",
+                "width",
+                "height",
+                "projectId",
+                "folderId",
+                "tags",
+                "status",
+                "embeddingStatus",
+                "createdAt",
+                "updatedAt"
+              ],
+              "additionalProperties": false
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Move Image Asset",
+          "readOnlyHint": false,
+          "destructiveHint": false,
+          "idempotentHint": true,
+          "openWorldHint": false
+        }
+      },
+      {
+        "id": "image_asset_delete",
+        "upstreamName": "image_asset_delete",
+        "description": "DESTRUCTIVE: delete one governed image asset, remove its semantic vectors, and purge private bytes when no other logical asset uses them. Retry with the same assetId if an earlier response was lost.",
+        "inputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "vault": {
+              "type": "string"
+            },
+            "assetId": {
+              "type": "string",
+              "minLength": 1
+            },
+            "confirmDelete": {
+              "type": "boolean",
+              "const": true,
+              "description": "Must be true after the caller has confirmed deletion."
+            }
+          },
+          "required": [
+            "assetId",
+            "confirmDelete"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "outputJsonSchema": {
+          "type": "object",
+          "properties": {
+            "ok": {
+              "type": "boolean",
+              "enum": [
+                true,
+                false
+              ]
+            },
+            "deleted": {
+              "type": "boolean"
+            },
+            "assetId": {
+              "type": "string"
+            },
+            "code": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "ok"
+          ],
+          "additionalProperties": false,
+          "$schema": "http://json-schema.org/draft-07/schema#"
+        },
+        "annotations": {
+          "title": "Delete Image Asset",
+          "readOnlyHint": false,
+          "destructiveHint": true,
+          "idempotentHint": true,
+          "openWorldHint": false
+        }
+      }
+    ];
+  }
+});
+
 // src/mcp/memory-tool-schemas.ts
 var import_zod50, AcceptShareSchema, ApproveSenderSchema, DeclineShareSchema, GetChatLinkSchema, GetVaultAppLinkSchema, InboxSettingsSchema, InviteAccountSchema, issueKeyTool_scopeShape, IssueKeySchema, ListApprovedSendersSchema, ListKeysSchema, NoteInboxSchema, RemoveApprovedSenderSchema, RevokeChatLinkSchema, RevokeKeySchema, RevokeShareSchema, RevokeVaultAppLinkSchema, SetAgentIdentitySchema, SetScopeSchema, ShareNoteSchema, ShareVaultSchema, SwapVaultSchema, SwitchAccountSchema, UnlinkShareSchema, memoryCaptureTool_notePropsSchema, MemoryCaptureSchema, MemoryQuestionsSchema, PrepareMemoryWriteSchema, validateMemoryWriteTool_notePropsSchema, ValidateMemoryWriteSchema, CreateChannelSchema, GetMessageNoteSchema, ListChannelMembersSchema, ListChannelMessagesSchema, MyMentionsSchema, PollChannelSchema, PostMessageSchema, ReactMessageSchema, RemoveChannelMemberSchema, ReplyMessageSchema, factHistoryTool_entryShape, FactHistorySchema, recordFactTool_factShape, RecordFactSchema, NoteBacklinksSchema, GraphPathSchema, GraphUniverseSchema, LibraryIngestSchema, bulkDeleteNotesTool_FilterSchema, BulkDeleteNotesSchema, DeleteNoteSchema, ExportSchema, getTool_notePropsSchema, GetSchema, listNoteSchema, ListSchema, putTool_notePropsSchema, PutSchema, searchTool_primitiveValue, SearchSchema, SuggestSchema, UploadSchema, TemporalRecallSchema, ScheduledArtifactSelectionSchema2, CreateScheduledActionSchema, UpdateScheduledActionSchema, DeleteScheduledActionSchema, GetScheduleLinkSchema, GetScheduleStatusSchema, ListScheduledActionsSchema, PauseScheduledActionSchema, ProposeScheduledActionSchema, ResumeScheduledActionSchema, RevokeScheduleLinkSchema, SetScheduleDefaultsSchema, SetScheduleEntitlementSchema, CostUsageSchema, StorageUsageSchema, CreateTableSchema, deleteTableRowsTool_FilterSchema, DeleteTableRowsSchema, DescribeTableSchema, DropTableSchema, InsertTableRowsSchema, ListTablesSchema, queryTableTool_FilterSchema, QueryTableSchema, ListTagsSchema, MergeTagsSchema, ResolveTagsSchema, UpsertTagSchema, AddVaultSchema, CreateSecureVaultSchema, DeleteVaultSchema, GetVaultContractSchema, ListSharedWithMeSchema, ListVaultsSchema, ProvisionDefaultsSchema, RouteMemorySchema, VideoAnalyzeStartSchema, VideoAnalyzeStatusSchema, CreateWebhookSchema, ListWebhooksSchema, RevokeWebhookSchema, MEMORY_TOOL_SCHEMAS;
 var init_memory_tool_schemas = __esm({
@@ -62256,11 +63865,11 @@ var init_memory_tool_schemas = __esm({
 });
 
 // src/mcp/memory-tool-registry.ts
-var import_image_assets, MEMORY_TOOL_DESCRIPTION_OVERRIDES, MEMORY_TOOL_REGISTRY;
+var MEMORY_TOOL_DESCRIPTION_OVERRIDES, MEMORY_TOOL_REGISTRY;
 var init_memory_tool_registry = __esm({
   "src/mcp/memory-tool-registry.ts"() {
     "use strict";
-    import_image_assets = require("mcpscraper-memory-tools/tools/assets/image-assets");
+    init_memory_image_tool_schemas_generated();
     init_memory_tool_schemas();
     MEMORY_TOOL_DESCRIPTION_OVERRIDES = {
       "access-swap-vault": "Set the account's persisted active vault so later memory calls may omit vault and use it by default across stateless requests. The vault must be entitled to the key and the key must hold 'swap' scope."
@@ -62270,7 +63879,7 @@ var init_memory_tool_registry = __esm({
         ...schema,
         description: MEMORY_TOOL_DESCRIPTION_OVERRIDES[schema.id] ?? schema.description
       })),
-      ...import_image_assets.IMAGE_ASSET_MCP_DEFINITIONS
+      ...MEMORY_IMAGE_TOOL_SCHEMAS
     ];
   }
 });
@@ -87558,8 +89167,6 @@ var init_server = __esm({
         if (checked.error) return c.json({ error: checked.error }, 400);
         body.callback_url = checked.parsed?.href;
       }
-      const limitErr = await checkHarvestLimits(user, c.req.header("x-mcp-scraper-concurrency-lock"));
-      if (limitErr) return c.json(limitErr, 429, { "Retry-After": "30" });
       const options = {
         query: body.query.trim(),
         location: body.location,
@@ -87581,6 +89188,26 @@ var init_server = __esm({
         includeAiOverview: body.includeAiOverview ?? false,
         includeWhatPeopleSaying: body.includeWhatPeopleSaying ?? false
       };
+      const suppliedIdempotencyKey = c.req.header("idempotency-key") ?? c.req.header("x-idempotency-key");
+      let derivedJobId = null;
+      let requestFingerprint3 = null;
+      if (!options.serpOnly && suppliedIdempotencyKey != null) {
+        const trimmedKey = suppliedIdempotencyKey.trim();
+        if (!trimmedKey || trimmedKey.length > 200) {
+          return c.json({ error: "Idempotency-Key must contain 1-200 characters.", errorCode: "invalid_idempotency_key", retryable: false }, 400);
+        }
+        derivedJobId = `paa-${sha256Hex(`${user.id}\0${trimmedKey}`).slice(0, 24)}`;
+        requestFingerprint3 = sha256Hex(JSON.stringify({ options, callbackUrl: body.callback_url ?? null }));
+        const existing = await getJob(derivedJobId, user.id);
+        if (existing) {
+          if (existing.options.requestFingerprint !== requestFingerprint3) {
+            return c.json({ error: "Idempotency-Key was already used for a different asynchronous harvest_paa call.", errorCode: "idempotency_conflict", retryable: false }, 409);
+          }
+          return c.json({ job_id: existing.id, status: existing.status, replayed: true }, ["done", "failed", "cancelled"].includes(existing.status) ? 200 : 202);
+        }
+      }
+      const limitErr = await checkHarvestLimits(user, c.req.header("x-mcp-scraper-concurrency-lock"));
+      if (limitErr) return c.json(limitErr, 429, { "Retry-After": "30" });
       const harvestCost = options.serpOnly ? MC_COSTS.serp_headful : paaCostForQuestionCount2(options.maxQuestions);
       let jobId2;
       if (options.serpOnly) {
@@ -87593,7 +89220,7 @@ var init_server = __esm({
         if (!harvestOk) return c.json(insufficientBalanceResponse(harvestBal, harvestCost), 402);
         jobId2 = await createJob(user.id, options.query, { ...options, billingHoldMc: harvestCost }, body.callback_url);
       } else {
-        jobId2 = (0, import_node_crypto72.randomUUID)();
+        jobId2 = derivedJobId ?? (0, import_node_crypto72.randomUUID)();
         const billingDebitKey = `paa-harvest:${jobId2}:hold`;
         const description = `PAA harvest: ${options.query}`.slice(0, 500);
         const hold = await debitMcIdempotent(
@@ -87609,9 +89236,14 @@ var init_server = __esm({
             ...options,
             executionOwner: "inngest",
             billingHoldMc: harvestCost,
-            billingDebitKey
+            billingDebitKey,
+            ...requestFingerprint3 ? { requestFingerprint: requestFingerprint3 } : {}
           }, body.callback_url);
         } catch (error) {
+          const existing = derivedJobId ? await getJob(derivedJobId, user.id).catch(() => null) : null;
+          if (existing && existing.options.requestFingerprint === requestFingerprint3) {
+            return c.json({ job_id: existing.id, status: existing.status, replayed: true }, 202);
+          }
           await settleDebitMcIdempotent(
             user.id,
             billingDebitKey,
@@ -89424,4 +91056,3 @@ async function main() {
   }
 }
 void main();
-//# sourceMappingURL=api-server.cjs.map