mcp-scraper 0.66.0 → 0.66.1

package/dist/bin/mcp-stdio-server.cjs

@@ -35,7 +35,7 @@ var import_node_crypto = require("crypto");
 
 // src/harvest-timeout.ts
 var SCRAPE_FUNCTION_MAX_MS = 8e5;
-var DEFAULT_TOOL_CLIENT_TIMEOUT_MS = 3e5;
+var DEFAULT_TOOL_CLIENT_TIMEOUT_MS = 59e4;
 var CLIENT_OVER_SERVER_MARGIN_MS = 15e3;
 function harvestTimeoutBudget(maxQuestions, serpOnly = false) {
   const requested = Number.isFinite(maxQuestions) && maxQuestions > 0 ? Math.trunc(maxQuestions) : 30;
@@ -213,8 +213,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":
@@ -515,7 +516,7 @@ var HttpMcpToolExecutor = class {
               retryable: true,
               path,
               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
@@ -601,6 +602,13 @@ var HttpMcpToolExecutor = class {
     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 } : {};
@@ -1222,7 +1230,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.0";
+var PACKAGE_VERSION = "0.66.1";
 
 // src/mcp/input-field-descriptions.ts
 var import_zod = require("zod");
@@ -13043,7 +13051,7 @@ function decodeTaskHandle(taskId, secret, ownerId) {
       decipher.update(ciphertext),
       decipher.final()
     ]).toString("utf8"));
-    if (parsed.v !== 1 || parsed.ownerId !== ownerId || !["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 !== ownerId || !["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_server2.ProtocolError(TASK_INVALID_PARAMS, "Failed to retrieve task: Task has expired");
     }
@@ -13056,9 +13064,25 @@ function decodeTaskHandle(taskId, secret, ownerId) {
 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;
@@ -13089,10 +13113,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 });
   }
@@ -13104,6 +13131,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 });
@@ -13120,7 +13171,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") {
@@ -13131,6 +13182,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,
@@ -13147,6 +13214,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";
@@ -13178,6 +13246,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);
@@ -13635,7 +13706,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.`,
@@ -14453,8 +14529,1532 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
 // src/mcp/memory-mcp-server.ts
 var import_server4 = require("@modelcontextprotocol/server");
 
-// src/mcp/memory-tool-registry.ts
-var import_image_assets = require("mcpscraper-memory-tools/tools/assets/image-assets");
+// src/mcp/memory-image-tool-schemas.generated.ts
+var 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_zod12 = require("zod");
@@ -16987,7 +18587,7 @@ var MEMORY_TOOL_REGISTRY = [
     ...schema,
     description: MEMORY_TOOL_DESCRIPTION_OVERRIDES[schema.id] ?? schema.description
   })),
-  ...import_image_assets.IMAGE_ASSET_MCP_DEFINITIONS
+  ...MEMORY_IMAGE_TOOL_SCHEMAS
 ];
 
 // src/mcp/memory-mcp-server.ts
@@ -17069,6 +18669,11 @@ var HostedMemoryMcpToolExecutor = class {
   }
 };
 
+// release-message.json
+var release_message_default = {
+  message: "Long PAA research now continues as a durable MCP Task with preserved progress, while transient browser interruptions return specific retry guidance instead of a generic outage."
+};
+
 // src/install-terminal.ts
 var CODES = {
   reset: "\x1B[0m",
@@ -17119,7 +18724,7 @@ function renderInstallTerminal(options) {
     colorize(ascii, "amber", color),
     `${colorize("MCP Scraper Agent", "cyan", color)}  .  v${options.version}  .  mcpscraper.dev`,
     "1/1 install surfaces ready",
-    colorize("Newest: any approved connection read can become an indexed Memory snapshot in one call. OAuth stays tenant-isolated and provider content is redacted and marked untrusted.", "lime", color),
+    colorize(`Newest in v${options.version}: ${release_message_default.message}`, "lime", color),
     "",
     `${colorize("Tools", "cyan", color)}  ${colorize("(259 MCP tools)", "muted", color)}`,
     toolRow("search", ["harvest_paa", "search_serp", "maps_search", "maps_place_intel"], color),
@@ -17905,4 +19510,3 @@ function buildStdioServer() {
 `);
   }
 });
-//# sourceMappingURL=mcp-stdio-server.cjs.map