mcp-scraper 0.66.0 → 0.66.2

package/dist/{chunk-SRRI2HJL.js → chunk-YKL3O7IU.js}

@@ -5,16 +5,16 @@ import {
   renderImageSection,
   renderIssueReport,
   renderLinkReport
-} from "./chunk-X7UG2JCF.js";
+} from "./chunk-PGJQDMC2.js";
 import {
   sanitizeOutboundDiagnostics
-} from "./chunk-VIWT35S6.js";
+} from "./chunk-3EYALCYK.js";
 import {
   browserServiceProfileName,
   browserServiceProfileSaveChanges,
   recordVendorUsage,
   vendorCostUsd
-} from "./chunk-4LINSJNI.js";
+} from "./chunk-3TKKJQB4.js";
 import {
   buildSerpEmailQuery,
   classifyEmailScope,
@@ -22,34 +22,34 @@ import {
   extractContactEvidence,
   extractSerpEmailEvidence,
   selectPrimaryEmail
-} from "./chunk-WD73OFL3.js";
+} from "./chunk-VXLU74YZ.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-HDYOVGC6.js";
+} from "./chunk-ALEBMPOW.js";
 import {
   createPrivateArtifact,
   privateArtifactOwnerId,
   readPrivateArtifactWindow,
   renewPrivateArtifactDownload
-} from "./chunk-EKJ65E3Z.js";
+} from "./chunk-DNM65UCK.js";
 import {
   MC_PER_CREDIT,
   PAA_BASE_CREDITS,
   PAA_QUESTION_CREDITS,
   PAGE_SCRAPE_CREDITS,
   SERP_SEARCH_CREDITS
-} from "./chunk-2XUXVKT4.js";
+} from "./chunk-AYJHI2FK.js";
 import {
   PUBLIC_ERROR_CODES,
   buildPublicErrorEnvelope,
   normalizePublicErrorCode,
   publicErrorMessage,
   sanitizeVendorName
-} from "./chunk-4VG3NUUY.js";
+} from "./chunk-55B3T5L2.js";
 
 // 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;
@@ -5006,60 +5006,10 @@ ${rows}` : ""
 }
 
 // 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/meta-ad-creative-media.ts
@@ -7160,7 +7110,7 @@ var HarvestPaaInputSchema = {
   gl: z6.string().length(2).default("us").describe("Google country code inferred from location or user language."),
   hl: z6.string().default("en").describe("Google interface/content language inferred from the user request."),
   device: z6.enum(["desktop", "mobile"]).default("desktop").describe("SERP device context. Use mobile only for mobile rankings."),
-  idempotencyKey: z6.string().trim().min(8).max(200).optional().describe("Retry key: reuse after a timeout to avoid re-billing. New key per harvest."),
+  idempotencyKey: z6.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: z6.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: z6.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: z6.boolean().default(false).describe("Include Google local/map-pack businesses and merge their entity IDs."),
@@ -7170,6 +7120,9 @@ var HarvestPaaInputSchema = {
   includeWhatPeopleSaying: z6.boolean().default(false).describe("Include the What People Are Saying social surface when present."),
   debug: z6.boolean().default(false).describe("Include sanitized diagnostics for debugging.")
 };
+var HarvestPaaHostedInputSchema = Object.fromEntries(
+  Object.entries(HarvestPaaInputSchema).filter(([name]) => name !== "debug")
+);
 var ExtractUrlBaseInputSchema = {
   url: z6.string().url().describe("Public http/https URL to extract."),
   screenshot: z6.boolean().default(false).describe("Capture a full-page screenshot. Large captures may be offloaded to an owned artifact."),
@@ -10378,6 +10331,15 @@ var TASK_TTL_MS = 24 * 60 * 60 * 1e3;
 var TASK_POLL_INTERVAL_MS = 5e3;
 var TASK_INVALID_PARAMS = -32602;
 var TASK_MISSING_CAPABILITY = -32003;
+var TASK_START_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "harvest_paa",
+  "extract_site",
+  "analyze_site_similarity",
+  "audit_site",
+  "video_frame_analysis",
+  "directory_workflow",
+  "lead_list_enrich"
+]);
 function hasTasksCapability(capabilityValue) {
   const capabilities = objectValue(capabilityValue);
   const extensions = objectValue(capabilities?.extensions);
@@ -10419,7 +10381,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 ProtocolError(TASK_INVALID_PARAMS, "Failed to retrieve task: Task has expired");
     }
@@ -10432,9 +10394,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;
@@ -10455,6 +10433,73 @@ 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 createdAtMs = Date.now();
+  const payload = {
+    v: 1,
+    ownerId: options.ownerId,
+    kind: seed.kind,
+    operationId: seed.operationId,
+    createdAtMs,
+    expiresAtMs: createdAtMs + TASK_TTL_MS
+  };
+  return {
+    resultType: "task",
+    taskId: encodeTaskHandle(payload, options.secret),
+    status: "working",
+    statusMessage: seed.statusMessage,
+    createdAt: new Date(createdAtMs).toISOString(),
+    lastUpdatedAt: new Date(createdAtMs).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 } : {}
+  };
+}
+async function startTaskTool(executor, toolName, rawArguments) {
+  const args = objectValue(rawArguments) ?? {};
+  if (toolName === "harvest_paa") {
+    const parsed = z7.object(HarvestPaaHostedInputSchema).strict().safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid harvest_paa arguments");
+    return { kind: "paa_harvest", result: await executor.startHarvestPaa({ ...parsed.data, debug: false }) };
+  }
+  if (toolName === "extract_site") {
+    const parsed = z7.object(ExtractSiteInputSchema).safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid extract_site arguments");
+    return { kind: "site_export", result: await executor.extractSite(parsed.data) };
+  }
+  if (toolName === "analyze_site_similarity") {
+    const parsed = z7.object(AnalyzeSiteSimilarityInputSchema).safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid analyze_site_similarity arguments");
+    return { kind: "site_export", result: await executor.analyzeSiteSimilarity(parsed.data) };
+  }
+  if (toolName === "audit_site") {
+    const parsed = z7.object(AuditSiteInputSchema).safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid audit_site arguments");
+    return { kind: "site_export", result: await executor.auditSite(parsed.data) };
+  }
+  if (toolName === "video_frame_analysis") {
+    const parsed = z7.object(VideoFrameAnalysisInputSchema).safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid video_frame_analysis arguments");
+    return { kind: "video_frame_analysis", result: await executor.videoFrameAnalysis(parsed.data) };
+  }
+  if (toolName === "directory_workflow") {
+    const parsed = z7.object(DirectoryWorkflowInputSchema).safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid directory_workflow arguments");
+    return { kind: "directory_workflow", result: await executor.directoryWorkflow(parsed.data) };
+  }
+  if (toolName === "lead_list_enrich") {
+    const parsed = z7.object(LeadListEnrichInputSchema).safeParse(args);
+    if (!parsed.success) throw new ProtocolError(TASK_INVALID_PARAMS, parsed.error.issues[0]?.message ?? "Invalid lead_list_enrich arguments");
+    return { kind: "lead_list_enrichment", result: await executor.leadListEnrich(parsed.data) };
+  }
+  throw new ProtocolError(TASK_INVALID_PARAMS, `Unsupported Task-start tool: ${toolName}`);
+}
 function taskBase(payload, taskId) {
   return {
     taskId,
@@ -10465,10 +10510,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 });
   }
@@ -10480,6 +10528,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 });
@@ -10496,7 +10568,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") {
@@ -10507,6 +10579,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,
@@ -10523,12 +10611,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]: {} }
   });
@@ -10554,34 +10650,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 createdAtMs = Date.now();
-      const payload = {
-        v: 1,
-        ownerId: options.ownerId,
-        kind: seed.kind,
-        operationId: seed.operationId,
-        createdAtMs,
-        expiresAtMs: createdAtMs + TASK_TTL_MS
-      };
-      const taskId = encodeTaskHandle(payload, options.secret);
-      return {
-        resultType: "task",
-        taskId,
-        status: "working",
-        statusMessage: seed.statusMessage,
-        createdAt: new Date(createdAtMs).toISOString(),
-        lastUpdatedAt: new Date(createdAtMs).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);
     }
   };
 }
@@ -10594,10 +10668,12 @@ function taskHttpError(id, error) {
 }
 async function handleMcpTasksHttpRequest(request, executor, options) {
   const routedMethod = request.headers.get("mcp-method");
-  if (!["tasks/get", "tasks/update", "tasks/cancel"].includes(routedMethod ?? "")) return void 0;
+  const routedToolName = request.headers.get("mcp-name");
+  const taskStartCall = routedMethod === "tools/call" && TASK_START_TOOL_NAMES.has(routedToolName ?? "");
+  if (!taskStartCall && !["tasks/get", "tasks/update", "tasks/cancel"].includes(routedMethod ?? "")) return void 0;
   let payload;
   try {
-    payload = await request.json();
+    payload = await request.clone().json();
   } catch {
     return taskHttpError(null, new ProtocolError(-32700, "Parse error"));
   }
@@ -10610,6 +10686,28 @@ async function handleMcpTasksHttpRequest(request, executor, options) {
       throw new ProtocolError(-32020, "Mcp-Method header does not match the JSON-RPC method");
     }
     const params = objectValue(payload.params);
+    if (taskStartCall) {
+      if (params?.name !== routedToolName || typeof routedToolName !== "string") {
+        throw new ProtocolError(-32020, "Mcp-Name header must match params.name");
+      }
+      const meta2 = objectValue(params?._meta);
+      if (!hasTasksCapability(meta2?.["io.modelcontextprotocol/clientCapabilities"])) return void 0;
+      if (routedToolName === "harvest_paa" && objectValue(params?.arguments)?.serpIdentity !== void 0) {
+        return void 0;
+      }
+      const started = await startTaskTool(executor, routedToolName, params?.arguments);
+      const task = createTaskResult(started.kind, started.result, options);
+      const taskObject = task;
+      return new Response(JSON.stringify({
+        jsonrpc: "2.0",
+        id,
+        result: {
+          ...taskObject,
+          resultType: taskObject.resultType === "task" ? "task" : "complete",
+          _meta: { "io.modelcontextprotocol/serverInfo": options.serverInfo }
+        }
+      }), { status: 200, headers: { "content-type": "application/json" } });
+    }
     const taskId = params?.taskId;
     if (typeof taskId !== "string" || !taskId) throw new ProtocolError(TASK_INVALID_PARAMS, "Invalid taskId");
     if (request.headers.get("mcp-name") !== taskId) {
@@ -11056,19 +11154,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(
@@ -11082,7 +11182,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.`,
@@ -12047,7 +12153,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
@@ -12130,8 +12236,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;
@@ -14335,8 +14450,1532 @@ function registerBrowserAgentMcpTools(server, opts) {
 // src/mcp/memory-mcp-server.ts
 import { fromJsonSchema } from "@modelcontextprotocol/server";
 
-// src/mcp/memory-tool-registry.ts
-import { IMAGE_ASSET_MCP_DEFINITIONS } from "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
 import { z as z11 } from "zod";
@@ -16869,7 +18508,7 @@ var MEMORY_TOOL_REGISTRY = [
     ...schema,
     description: MEMORY_TOOL_DESCRIPTION_OVERRIDES[schema.id] ?? schema.description
   })),
-  ...IMAGE_ASSET_MCP_DEFINITIONS
+  ...MEMORY_IMAGE_TOOL_SCHEMAS
 ];
 
 // src/mcp/memory-mcp-server.ts
@@ -17626,4 +19265,3 @@ export {
   ScheduledResultsMcpExecutor,
   registerScheduledResultsMcpTools
 };
-//# sourceMappingURL=chunk-SRRI2HJL.js.map