mcp-scraper 0.66.0 → 0.66.2

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
@@ -598,8 +599,17 @@ var HttpMcpToolExecutor = class {
   }
   harvestPaa(input) {
     const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(input.maxQuestions ?? 30).clientMs;
-    const headers = input.idempotencyKey ? { "Idempotency-Key": input.idempotencyKey } : {};
-    return this.call("/harvest/sync", input, timeoutMs, "POST", headers, true);
+    const { idempotencyKey, ...body } = input;
+    const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {};
+    return this.call("/harvest/sync", body, timeoutMs, "POST", headers, true);
+  }
+  startHarvestPaa(input) {
+    const { idempotencyKey, ...body } = input;
+    const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {};
+    return this.call("/harvest", body, this.timeoutMs, "POST", headers, true);
+  }
+  harvestPaaStatus(input) {
+    return this.getJson(`/jobs/${encodeURIComponent(input.jobId)}`);
   }
   searchSerp(input) {
     const timeoutMs = this.httpTimeoutOverrideMs ?? harvestTimeoutBudget(0, true).clientMs;
@@ -1222,7 +1232,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.0";
+var PACKAGE_VERSION = "0.66.2";
 
 // src/mcp/input-field-descriptions.ts
 var import_zod = require("zod");
@@ -2227,60 +2237,10 @@ async function annotateReplayVideo(inputFilePath, outputFilePath, options) {
 }
 
 // src/mcp/output-schema-registry.ts
-var ESSENTIAL_OUTPUT_SCHEMA_TOOLS = /* @__PURE__ */ new Set([
-  "extract_url",
-  "extract_site",
-  "analyze_site_similarity",
-  "audit_site",
-  "check_site_export",
-  "site_export_read",
-  "site_export_image",
-  "archive_read",
-  "report_artifact_read",
-  "directory_workflow",
-  "directory_workflow_status",
-  "lead_list_upload_start",
-  "lead_list_import",
-  "lead_list_enrich",
-  "lead_list_enrich_status",
-  "video_frame_analysis",
-  "video_frame_analysis_status",
-  "workflow_run",
-  "workflow_step",
-  "workflow_status",
-  "workflow_artifact_read",
-  "export_connected_service_data",
-  "export_search_console_table_data",
-  "renew_connected_data_download",
-  "browser_open",
-  "browser_screenshot",
-  "browser_replay_start",
-  "browser_replay_stop",
-  "browser_replay_download",
-  "create_scheduled_run_view_link",
-  "get_scheduled_run",
-  "library-ingest",
-  "image_project_create",
-  "image_project_list",
-  "image_folder_create",
-  "image_folder_list",
-  "image_asset_save",
-  "image_asset_get",
-  "image_asset_list",
-  "image_asset_search",
-  "image_asset_move",
-  "image_asset_delete"
-]);
-function resolveOutputSchemaMode(env = process.env) {
-  const explicit = env.MCP_SCRAPER_OUTPUT_SCHEMA_MODE?.trim().toLowerCase();
-  if (explicit === "none" || explicit === "essential" || explicit === "all") return explicit;
-  return env.MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS === "true" ? "all" : "none";
-}
-var OUTPUT_SCHEMA_MODE = resolveOutputSchemaMode();
 var OUTPUT_SCHEMAS = {};
 function recordOutputSchema(name, schema) {
   OUTPUT_SCHEMAS[name] = schema;
-  return OUTPUT_SCHEMA_MODE === "all" || OUTPUT_SCHEMA_MODE === "essential" && ESSENTIAL_OUTPUT_SCHEMA_TOOLS.has(name) ? schema : void 0;
+  return schema;
 }
 
 // src/mcp/browser-agent-mcp-server.ts
@@ -9772,7 +9732,7 @@ var HarvestPaaInputSchema = {
   gl: import_zod8.z.string().length(2).default("us").describe("Google country code inferred from location or user language."),
   hl: import_zod8.z.string().default("en").describe("Google interface/content language inferred from the user request."),
   device: import_zod8.z.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only for mobile rankings."),
-  idempotencyKey: import_zod8.z.string().trim().min(8).max(200).optional().describe("Retry key: reuse after a timeout to avoid re-billing. New key per harvest."),
+  idempotencyKey: import_zod8.z.string().trim().min(8).max(200).optional().describe("Optional duplicate-start key. Reuse it only after an uncertain or lost response to the same logical call; use a new key for an intentional retry after a terminal failure. This is not the run identifier."),
   serpIdentity: import_zod8.z.string().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/).optional().describe("Optional persistent SERP identity created with serp_identity_create. Reuses the same saved browser state and fixed network address across calls."),
   includeAllSerpFeatures: import_zod8.z.boolean().default(false).describe("Capture every optional same-page SERP surface: local pack, forums, videos, AI Overview/AI Mode, and What People Are Saying."),
   includeLocalPack: import_zod8.z.boolean().default(false).describe("Include Google local/map-pack businesses and merge their entity IDs."),
@@ -9782,6 +9742,9 @@ var HarvestPaaInputSchema = {
   includeWhatPeopleSaying: import_zod8.z.boolean().default(false).describe("Include the What People Are Saying social surface when present."),
   debug: import_zod8.z.boolean().default(false).describe("Include sanitized diagnostics for debugging.")
 };
+var HarvestPaaHostedInputSchema = Object.fromEntries(
+  Object.entries(HarvestPaaInputSchema).filter(([name]) => name !== "debug")
+);
 var ExtractUrlBaseInputSchema = {
   url: import_zod8.z.string().url().describe("Public http/https URL to extract."),
   screenshot: import_zod8.z.boolean().default(false).describe("Capture a full-page screenshot. Large captures may be offloaded to an owned artifact."),
@@ -13043,7 +13006,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 +13019,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;
@@ -13079,6 +13058,34 @@ function taskSeed(kind, result) {
   if (structured.ok !== true || !["queued", "running", "processing", "pending"].includes(String(structured.status))) return void 0;
   return { kind, operationId, statusMessage: "Video analysis is running." };
 }
+function createTaskResult(kind, result, options) {
+  const seed = taskSeed(kind, result);
+  if (!seed) return result;
+  const createdAtMs2 = Date.now();
+  const payload = {
+    v: 1,
+    ownerId: options.ownerId,
+    kind: seed.kind,
+    operationId: seed.operationId,
+    createdAtMs: createdAtMs2,
+    expiresAtMs: createdAtMs2 + TASK_TTL_MS
+  };
+  return {
+    resultType: "task",
+    taskId: encodeTaskHandle(payload, options.secret),
+    status: "working",
+    statusMessage: seed.statusMessage,
+    createdAt: new Date(createdAtMs2).toISOString(),
+    lastUpdatedAt: new Date(createdAtMs2).toISOString(),
+    ttlMs: TASK_TTL_MS,
+    pollIntervalMs: TASK_POLL_INTERVAL_MS,
+    // The registered SDK path validates structuredContent against the tool's
+    // terminal output schema before it can serialize a Task envelope. Retain
+    // the bounded start receipt for that path; the hosted HTTP Task seam runs
+    // before terminal-output serialization.
+    ...result.structuredContent ? { structuredContent: result.structuredContent } : {}
+  };
+}
 function taskBase(payload, taskId) {
   return {
     taskId,
@@ -13089,10 +13096,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 +13114,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 +13154,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 +13165,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,12 +13197,20 @@ 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";
   return status === "queued" || status === "running" || status === "processing" || status === "pending";
 }
 function registerMcpTasksExtension(server, executor, options) {
+  const enabled = options.enableTaskStarts !== false;
+  if (!enabled) {
+    return {
+      supportsTasks: () => false,
+      taskify: (_kind, result) => result
+    };
+  }
   server.server.registerCapabilities({
     extensions: { [MCP_TASKS_EXTENSION_ID]: {} }
   });
@@ -13178,34 +13236,12 @@ 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);
-      if (!seed) return result;
-      const createdAtMs2 = Date.now();
-      const payload = {
-        v: 1,
-        ownerId: options.ownerId,
-        kind: seed.kind,
-        operationId: seed.operationId,
-        createdAtMs: createdAtMs2,
-        expiresAtMs: createdAtMs2 + TASK_TTL_MS
-      };
-      const taskId = encodeTaskHandle(payload, options.secret);
-      return {
-        resultType: "task",
-        taskId,
-        status: "working",
-        statusMessage: seed.statusMessage,
-        createdAt: new Date(createdAtMs2).toISOString(),
-        lastUpdatedAt: new Date(createdAtMs2).toISOString(),
-        ttlMs: TASK_TTL_MS,
-        pollIntervalMs: TASK_POLL_INTERVAL_MS,
-        // The SDK validates advertised outputSchema before serializing the
-        // Task envelope. Preserve the already-bounded start receipt so typed
-        // tools remain task-capable when essential output schemas are on.
-        ...result.structuredContent ? { structuredContent: result.structuredContent } : {}
-      };
+      return createTaskResult(kind, result, options);
     }
   };
 }
@@ -13609,19 +13645,21 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   const fileBehavior = (local, hosted) => savesReports ? local : hosted;
   const ownerId = options.ownerId ?? "local";
   const ctx = { hosted: !savesReports, ownerId };
+  const transportProfile = options.transportProfile ?? (savesReports ? "stdio" : "hosted_http");
   registerAnalyticsMcpTools(server, executor);
   const exposesLocalNetworkAccess = options.localNetworkAccess ?? permitsLocalNetworkAccess({
     deploymentProfile: options.deploymentProfile ?? "production",
-    transportProfile: options.transportProfile ?? (savesReports ? "stdio" : "hosted_http"),
+    transportProfile,
     baseUrl: options.baseUrl
   });
   const exposesDevelopmentDiagnostics = options.deploymentProfile === "development" || options.deploymentProfile === "test";
   const tasks = registerMcpTasksExtension(server, executor, {
     ownerId,
-    secret: options.taskHandleSecret ?? `local:${ownerId}`
+    secret: options.taskHandleSecret ?? `local:${ownerId}`,
+    enableTaskStarts: transportProfile === "hosted_http"
   });
   const privateSearchFields = exposesDevelopmentDiagnostics ? [] : ["debug"];
-  const harvestPaaInputSchema = schemaWithoutFields(HarvestPaaInputSchema, privateSearchFields);
+  const harvestPaaInputSchema = exposesDevelopmentDiagnostics ? HarvestPaaInputSchema : HarvestPaaHostedInputSchema;
   const searchSerpInputSchema = schemaWithoutFields(SearchSerpInputSchema, privateSearchFields);
   const mapsSearchInputSchema = schemaWithoutFields(MapsSearchInputSchema, privateSearchFields);
   const directoryWorkflowInputSchema = schemaWithoutFields(
@@ -13635,7 +13673,13 @@ 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) => {
+    const executionInput = { ...input, debug: input.debug === true };
+    if (tasks.supportsTasks() && !executionInput.serpIdentity) {
+      return tasks.taskify("paa_harvest", await executor.startHarvestPaa(executionInput), requestContext);
+    }
+    return formatHarvestPaa(await executor.harvestPaa(executionInput), executionInput);
+  });
   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 +14497,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 +18555,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 +18637,11 @@ var HostedMemoryMcpToolExecutor = class {
   }
 };
 
+// release-message.json
+var release_message_default = {
+  message: "PAA work now starts immediately on the direct runtime, and every MCP Scraper install exposes the same complete typed tool contract."
+};
+
 // src/install-terminal.ts
 var CODES = {
   reset: "\x1B[0m",
@@ -17119,7 +18692,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 +19478,3 @@ function buildStdioServer() {
 `);
   }
 });
-//# sourceMappingURL=mcp-stdio-server.cjs.map