@fload-ai/mcp 0.2.1 → 0.2.2

package/dist/bin.js

@@ -91,9 +91,12 @@ async function listApps(input, client) {
   try {
     const response = await client.get("/api/assets", {
       limit: input.limit,
-      offset: 0
+      offset: 0,
+      // The listing hides assets without a valuation by default; "list all
+      // apps" must include apps that haven't been valued yet (FLO-734).
+      includeUnvalued: "true"
     });
-    const apps = response.data || [];
+    const apps = response.data ?? [];
     const filtered = input.platform ? apps.filter((app) => {
       if (input.platform === "ios")
         return !!app.appleAppId;
@@ -137,8 +140,14 @@ async function getAppDetails(input, client) {
     }
     let assetId = input.assetId;
     if (!assetId && input.bundleId) {
-      const allApps = await client.get("/api/assets", { limit: 100, offset: 0 });
-      const match = (allApps.data || []).find((a) => a.bundleId === input.bundleId);
+      const allApps = await client.get("/api/assets", {
+        limit: 100,
+        offset: 0,
+        includeUnvalued: "true"
+      });
+      const match = (allApps.data ?? []).find(
+        (app2) => app2.bundleId === input.bundleId
+      );
       if (!match) {
         return {
           content: [
@@ -152,8 +161,13 @@ async function getAppDetails(input, client) {
       }
       assetId = match.id;
     }
-    const response = await client.get(`/api/assets/${assetId}`);
-    const app = response.data || response;
+    const response = await client.get(
+      `/api/assets/${assetId}`
+    );
+    const app = response.data;
+    if (!app) {
+      throw new Error("App details response did not include app data");
+    }
     return {
       content: [
         {
@@ -210,14 +224,27 @@ var sendReviewReplySchema = z2.object({
 });
 var translateReviewSchema = z2.object({
   reviewId: z2.string().describe("The review UUID to translate"),
-  assetId: z2.string().uuid().describe("The app UUID the review belongs to")
+  assetId: z2.string().uuid().describe("The app UUID the review belongs to"),
+  // The translate endpoint receives the review content in the request body
+  // (it does not re-fetch it). Pass the fields from a get_reviews result.
+  rating: z2.number().int().min(1).max(5).describe("The review star rating, from get_reviews"),
+  title: z2.string().default("").describe("The review title, from get_reviews"),
+  body: z2.string().describe("The review text to translate, from get_reviews"),
+  storeFront: z2.string().default("").describe('The review storefront (e.g. "SE"), from get_reviews'),
+  appVersionString: z2.string().default("").describe("The app version the review was left on, from get_reviews")
 });
 async function getReviews(input, client) {
   try {
     let assetId = input.assetId;
     if (!assetId && input.bundleId) {
-      const allApps = await client.get("/api/assets", { limit: 100, offset: 0 });
-      const match = (allApps.data || []).find((a) => a.bundleId === input.bundleId);
+      const allApps = await client.get("/api/assets", {
+        limit: 100,
+        offset: 0,
+        includeUnvalued: "true"
+      });
+      const match = (allApps.data ?? []).find(
+        (app) => app.bundleId === input.bundleId
+      );
       if (!match) {
         return {
           content: [
@@ -231,12 +258,20 @@ async function getReviews(input, client) {
       }
       assetId = match.id;
     }
+    if (!assetId) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "Provide an assetId (or bundleId) to fetch reviews for. Use list_apps to find app IDs."
+          }
+        ],
+        isError: true
+      };
+    }
     const params = {
-      limit: input.limit,
-      sortBy: input.sortBy
+      limit: input.limit
     };
-    if (assetId)
-      params.assetId = assetId;
     if (input.platform)
       params.platform = input.platform;
     if (input.rating !== void 0)
@@ -247,13 +282,25 @@ async function getReviews(input, client) {
       params.startDate = input.startDate;
     if (input.endDate)
       params.endDate = input.endDate;
-    const response = await client.get("/api/reviews", params);
-    const reviews = response.data || response.reviews || [];
+    const response = await client.get(
+      `/api/assets/${assetId}/reviews`,
+      params
+    );
+    let reviews = response.data?.reviews ?? [];
+    if (input.sortBy === "rating") {
+      reviews = [...reviews].sort(
+        (a, b) => Number(b.rating ?? 0) - Number(a.rating ?? 0)
+      );
+    }
+    const hasReply = (review) => !!(review.developerResponse || review.replySource || review.hasReply);
     const summary = {
       totalReviews: reviews.length,
-      averageRating: reviews.length > 0 ? (reviews.reduce((sum, r) => sum + (r.rating || 0), 0) / reviews.length).toFixed(2) : 0,
-      repliedCount: reviews.filter((r) => r.developerResponse || r.hasReply).length,
-      unrepliedCount: reviews.filter((r) => !r.developerResponse && !r.hasReply).length
+      averageRating: reviews.length > 0 ? (reviews.reduce((sum, review) => {
+        const rating = Number(review.rating ?? 0);
+        return sum + (Number.isFinite(rating) ? rating : 0);
+      }, 0) / reviews.length).toFixed(2) : 0,
+      repliedCount: reviews.filter((review) => hasReply(review)).length,
+      unrepliedCount: reviews.filter((review) => !hasReply(review)).length
     };
     return {
       content: [
@@ -261,19 +308,23 @@ async function getReviews(input, client) {
           type: "text",
           text: formatAsJson({
             summary,
-            reviews: reviews.map((r) => ({
-              id: r.id,
-              appId: r.appId,
-              platform: r.platform,
-              rating: r.rating,
-              title: r.title,
-              body: r.body,
-              author: r.nickname || r.author,
-              date: r.lastModified || r.date,
-              version: r.appVersionString || r.version,
-              storeFront: r.storeFront,
-              hasReply: !!(r.developerResponse || r.hasReply),
-              reply: r.developerResponse ? typeof r.developerResponse === "object" ? r.developerResponse.response : r.developerResponse : r.reply || null
+            reviews: reviews.map((review) => ({
+              id: review.id,
+              appId: review.appId,
+              platform: review.platform,
+              rating: review.rating,
+              title: review.title,
+              // The handler exposes the review text as `review`.
+              body: review.review ?? review.body,
+              author: review.nickname || review.author,
+              // Epoch ms from the handler.
+              date: review.lastModified || review.date,
+              version: review.appVersionString || review.version,
+              storeFront: review.storeFront,
+              hasReply: hasReply(review),
+              replySource: review.replySource ?? null,
+              hasDraft: review.hasDraft ?? false,
+              reply: review.developerResponse ? typeof review.developerResponse === "object" ? review.developerResponse.response : review.developerResponse : review.reply || null
             }))
           })
         }
@@ -293,9 +344,10 @@ async function getReviews(input, client) {
 }
 async function generateReviewReply(input, client) {
   try {
-    const response = await client.post(`/api/reviews/${input.reviewId}/generate-reply`, {
-      assetId: input.assetId
-    });
+    const response = await client.post(
+      `/api/assets/${input.assetId}/reviews/${input.reviewId}/generate-reply`,
+      void 0
+    );
     return {
       content: [
         {
@@ -318,10 +370,11 @@ async function generateReviewReply(input, client) {
 }
 async function sendReviewReply(input, client) {
   try {
-    const response = await client.post(`/api/reviews/${input.reviewId}/respond`, {
-      assetId: input.assetId,
-      response: input.response
-    });
+    const response = await client.post(
+      `/api/assets/${input.assetId}/reviews/${input.reviewId}/respond`,
+      // The API handler reads `responseText` from the body.
+      { responseText: input.response }
+    );
     return {
       content: [
         {
@@ -344,9 +397,18 @@ async function sendReviewReply(input, client) {
 }
 async function translateReview(input, client) {
   try {
-    const response = await client.post(`/api/reviews/${input.reviewId}/translate`, {
-      assetId: input.assetId
-    });
+    const response = await client.post(
+      `/api/assets/${input.assetId}/reviews/${input.reviewId}/translate`,
+      // The translate endpoint expects the review content in the body.
+      {
+        rating: input.rating,
+        title: input.title,
+        review: input.body,
+        storeFront: input.storeFront,
+        appVersionString: input.appVersionString,
+        lastModified: Date.now()
+      }
+    );
     return {
       content: [
         {
@@ -426,9 +488,11 @@ var DIMENSION_INFO = {
 };
 async function discoverMetrics(input, client) {
   try {
-    const response = await client.get(`/api/assets/${input.assetId}/metrics/availability`);
-    const availableMetrics = response.data?.availableMetrics || [];
-    const metricGroups = response.data?.metricGroups || {};
+    const response = await client.get(
+      `/api/assets/${input.assetId}/metrics/availability`
+    );
+    const availableMetrics = response.data?.availableMetrics ?? [];
+    const metricGroups = response.data?.metricGroups ?? {};
     const enriched = availableMetrics.map((metricName) => {
       const info = METRIC_INFO[metricName];
       return {
@@ -479,10 +543,13 @@ async function getMetrics(input, client) {
     if (input.dimensionFilter && input.dimension) {
       params[`filter.${input.dimension}`] = input.dimensionFilter;
     }
-    const response = await client.get(`/api/assets/${input.assetId}/metrics/timeseries`, params);
-    const data = response.data || {};
-    const changes = response.changes || {};
-    const meta = response.meta || {};
+    const response = await client.get(
+      `/api/assets/${input.assetId}/metrics/timeseries`,
+      params
+    );
+    const data = response.data ?? {};
+    const changes = response.changes ?? {};
+    const meta = response.meta ?? {};
     const summaries = {};
     for (const [metricName, timeseries] of Object.entries(data)) {
       const points = timeseries;
@@ -538,17 +605,20 @@ async function discoverDimensions(input, client) {
             assetId: input.assetId,
             dimension: input.dimension,
             displayName: DIMENSION_INFO[input.dimension] || input.dimension,
-            values: response2.data || response2
+            values: response2.data ?? response2
           })
         }]
       };
     }
     const response = await client.get(`/api/assets/${input.assetId}/metrics/dimensions`);
-    const dimensions = response.data || response || [];
-    const enriched = (Array.isArray(dimensions) ? dimensions : Object.keys(dimensions)).map((dim) => ({
-      name: dim,
-      displayName: DIMENSION_INFO[dim] || dim
-    }));
+    const dimensions = Array.isArray(response.data) ? response.data : [];
+    const enriched = dimensions.map((dim) => {
+      if (typeof dim === "string") {
+        return { name: dim, displayName: DIMENSION_INFO[dim] || dim };
+      }
+      const id = dim.id ?? "";
+      return { name: id, displayName: dim.label ?? DIMENSION_INFO[id] ?? id };
+    });
     return {
       content: [{
         type: "text",
@@ -566,6 +636,9 @@ async function discoverDimensions(input, client) {
 
 // src/tools/agents.ts
 import { z as z4 } from "zod";
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
 var AGENT_TYPES = [
   "review",
   "monitoring",
@@ -614,7 +687,7 @@ async function listAgents(_input, client) {
     let apiAgents = null;
     try {
       const response = await client.get("/api/agents");
-      apiAgents = response.data || response.agents || response;
+      apiAgents = Array.isArray(response) ? response : response.data ?? response.agents ?? null;
     } catch {
     }
     if (apiAgents && Array.isArray(apiAgents)) {
@@ -664,21 +737,26 @@ async function getAgentDetails(input, client) {
       const params = {};
       if (input.assetId)
         params.assetId = input.assetId;
-      const response2 = await client.get(`/api/agents/${input.agentType}`, params);
-      return {
-        content: [
-          {
-            type: "text",
-            text: formatAsJson(response2.data || response2)
-          }
-        ]
-      };
+      const response2 = await client.get(`/api/agents/by-type/${input.agentType}`, params);
+      if (response2.agent) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatAsJson({
+                agent: response2.agent,
+                recentRuns: response2.recentRuns ?? []
+              })
+            }
+          ]
+        };
+      }
     } catch {
     }
     const response = {
       type: input.agentType,
       description: AGENT_DESCRIPTIONS[input.agentType],
-      message: "Detailed agent configuration is available through the platform dashboard."
+      message: `No ${input.agentType} agent is provisioned for this organization yet. Activate it from the Agents page or with trigger_agent_run once created.`
     };
     return {
       content: [
@@ -702,33 +780,44 @@ async function getAgentDetails(input, client) {
 }
 async function getAgentRunHistory(input, client) {
   try {
+    let agentId;
     try {
-      const params = {
-        limit: input.limit
-      };
+      const byTypeParams = {};
       if (input.assetId)
-        params.assetId = input.assetId;
-      const response = await client.get(`/api/agents/${input.agentType}/runs`, params);
+        byTypeParams.assetId = input.assetId;
+      const byType = await client.get(
+        `/api/agents/by-type/${input.agentType}`,
+        byTypeParams
+      );
+      agentId = byType.agent?.id;
+    } catch {
+    }
+    if (!agentId) {
       return {
         content: [
           {
             type: "text",
             text: formatAsJson({
               agentType: input.agentType,
-              ...response.data || response
+              runs: [],
+              message: `No ${input.agentType} agent is provisioned for this organization yet, so there is no run history.`
             })
           }
         ]
       };
-    } catch {
     }
+    const response = await client.get(
+      `/api/agents/${agentId}/runs`,
+      { limit: input.limit }
+    );
     return {
       content: [
         {
           type: "text",
           text: formatAsJson({
             agentType: input.agentType,
-            message: `Run history for ${input.agentType} agent is available through the platform dashboard. This agent type does not have a dedicated run log table yet.`
+            agentId,
+            ...asRecord(response.data ?? response)
           })
         }
       ]
@@ -747,15 +836,16 @@ async function getAgentRunHistory(input, client) {
 }
 async function triggerAgentRun(input, client) {
   try {
-    const body = {};
-    if (input.assetId)
-      body.assetId = input.assetId;
-    const response = await client.post(`/api/agents/${input.agentId}/run`, body);
+    const body = input.assetId ? { triggerContext: { assetId: input.assetId } } : {};
+    const response = await client.post(
+      `/api/agents/${input.agentId}/run`,
+      body
+    );
     return {
       content: [
         {
           type: "text",
-          text: formatAsJson(response.data || response)
+          text: formatAsJson(response.data ?? response)
         }
       ]
     };
@@ -773,12 +863,14 @@ async function triggerAgentRun(input, client) {
 }
 async function pauseAgent(input, client) {
   try {
-    const response = await client.post(`/api/agents/${input.agentId}/pause`);
+    const response = await client.post(
+      `/api/agents/${input.agentId}/pause`
+    );
     return {
       content: [
         {
           type: "text",
-          text: formatAsJson(response.data || response)
+          text: formatAsJson(response.data ?? response)
         }
       ]
     };
@@ -796,12 +888,14 @@ async function pauseAgent(input, client) {
 }
 async function resumeAgent(input, client) {
   try {
-    const response = await client.post(`/api/agents/${input.agentId}/resume`);
+    const response = await client.post(
+      `/api/agents/${input.agentId}/resume`
+    );
     return {
       content: [
         {
           type: "text",
-          text: formatAsJson(response.data || response)
+          text: formatAsJson(response.data ?? response)
         }
       ]
     };
@@ -819,12 +913,14 @@ async function resumeAgent(input, client) {
 }
 async function getAgentActivity(input, client) {
   try {
-    const response = await client.get(`/api/agents/${input.agentId}/activity`);
+    const response = await client.get(
+      `/api/agents/${input.agentId}/activity`
+    );
     return {
       content: [
         {
           type: "text",
-          text: formatAsJson(response.data || response)
+          text: formatAsJson(response.data ?? response)
         }
       ]
     };
@@ -882,34 +978,40 @@ async function getAnomalies(input, client) {
       params.fromDate = input.fromDate;
     if (input.toDate)
       params.toDate = input.toDate;
-    if (input.excludeDismissed)
-      params.excludeDismissed = input.excludeDismissed;
-    const response = await client.get("/api/anomalies", params);
-    const anomalies = response.data || response.anomalies || [];
+    const response = await client.get(
+      "/api/anomalies",
+      params
+    );
+    let anomalies = response.data ?? response.anomalies ?? [];
+    if (input.excludeDismissed && !input.status) {
+      anomalies = anomalies.filter((a) => a.status !== "dismissed");
+    }
     return {
       content: [
         {
           type: "text",
           text: formatAsJson({
             total: anomalies.length,
-            anomalies: anomalies.map((a) => ({
-              id: a.id,
-              assetId: a.assetId,
-              assetName: a.assetName,
-              assetIcon: a.assetIcon,
-              anomalyDate: a.anomalyDate,
-              metricName: a.metricName,
-              sourceType: a.sourceType,
-              type: a.type,
-              severity: a.severity,
-              actualValue: parseFloat(a.actualValue || "0"),
-              expectedValue: parseFloat(a.expectedValue || "0"),
-              deviationPercent: parseFloat(a.deviationPercent || "0"),
-              confidence: parseFloat(a.confidence || "0"),
-              explanation: a.explanation,
-              suggestedActions: a.suggestedActions,
-              status: a.status,
-              detectedAt: a.detectedAt
+            anomalies: anomalies.map((anomaly) => ({
+              id: anomaly.id,
+              assetId: anomaly.assetId,
+              assetName: anomaly.assetName,
+              assetIcon: anomaly.assetIcon,
+              anomalyDate: anomaly.anomalyDate,
+              metricName: anomaly.metricName,
+              sourceType: anomaly.sourceType,
+              type: anomaly.type,
+              severity: anomaly.severity,
+              actualValue: parseFloat(String(anomaly.actualValue || "0")),
+              expectedValue: parseFloat(String(anomaly.expectedValue || "0")),
+              deviationPercent: parseFloat(
+                String(anomaly.deviationPercent || "0")
+              ),
+              confidence: parseFloat(String(anomaly.confidence || "0")),
+              explanation: anomaly.explanation,
+              suggestedActions: anomaly.suggestedActions,
+              status: anomaly.status,
+              detectedAt: anomaly.detectedAt
             }))
           })
         }
@@ -1008,37 +1110,46 @@ var getAdsPerformanceSchema = z6.object({
 });
 async function getAdsPerformance(input, client) {
   try {
-    const params = {
-      limit: input.limit
-    };
+    const params = {};
     if (input.assetId)
       params.assetId = input.assetId;
-    if (input.platform)
-      params.platform = input.platform;
     if (input.fromDate)
-      params.fromDate = input.fromDate;
+      params.from = input.fromDate;
     if (input.toDate)
-      params.toDate = input.toDate;
-    const response = await client.get("/api/ads/campaigns", params);
-    const campaigns = response.data || response.campaigns || [];
+      params.to = input.toDate;
+    const response = await client.get(
+      "/api/ads-agent/campaigns",
+      params
+    );
+    let campaigns = response.data ?? response.campaigns ?? [];
+    if (input.platform) {
+      campaigns = campaigns.filter((c) => c.platform === input.platform);
+    }
+    campaigns = campaigns.slice(0, input.limit);
     return {
       content: [
         {
           type: "text",
           text: formatAsJson({
             total: campaigns.length,
-            campaigns: campaigns.map((c) => ({
-              id: c.id,
-              assetId: c.assetId,
-              assetName: c.assetName,
-              platformCampaignId: c.platformCampaignId,
-              name: c.name,
-              status: c.status,
-              objective: c.objective,
-              platform: c.platform,
-              linkSource: c.linkSource,
-              linkedAt: c.linkedAt,
-              recentPerformance: c.recentPerformance || null
+            campaigns: campaigns.map((campaign) => ({
+              id: campaign.id,
+              assetId: campaign.assetId,
+              assetName: campaign.assetName,
+              platformCampaignId: campaign.platformCampaignId,
+              name: campaign.name,
+              status: campaign.status,
+              objective: campaign.objective,
+              platform: campaign.platform,
+              linkSource: campaign.linkSource,
+              linkedAt: campaign.linkedAt,
+              totalSpend: campaign.totalSpend ?? null,
+              totalImpressions: campaign.totalImpressions ?? null,
+              totalTaps: campaign.totalTaps ?? null,
+              totalInstalls: campaign.totalInstalls ?? null,
+              avgCPI: campaign.avgCPI ?? null,
+              avgTTR: campaign.avgTTR ?? null,
+              avgCVR: campaign.avgCVR ?? null
             }))
           })
         }
@@ -1116,13 +1227,17 @@ async function getGrowthScore(input, client) {
 import { z as z8 } from "zod";
 var getForecastsSchema = z8.object({
   assetId: z8.string().uuid().describe("App UUID to get forecasts for"),
-  dataPoints: z8.number().int().min(4).max(52).default(12).describe("Number of historical data points to include")
+  metric: z8.enum(["proceeds", "total_revenue", "total_downloads", "active_subs", "new_trials"]).describe("The metric to forecast"),
+  forecastWeeks: z8.number().int().min(4).max(156).optional().describe("Weeks to forecast forward (default 104)"),
+  historicalWeeks: z8.number().int().min(12).max(156).optional().describe("Weeks of history to base the forecast on (default 104)")
 });
 async function getForecasts(input, client) {
   try {
     const response = await client.get("/api/forecasting/forecast", {
       assetId: input.assetId,
-      dataPoints: input.dataPoints
+      metricName: input.metric,
+      forecastWeeks: input.forecastWeeks,
+      historicalWeeks: input.historicalWeeks
     });
     return {
       content: [
@@ -1147,18 +1262,34 @@ async function getForecasts(input, client) {
 
 // src/tools/dashboard.ts
 import { z as z9 } from "zod";
+function parseDashboardNumber(value) {
+  if (value === null || value === void 0 || value === "")
+    return null;
+  const parsed = typeof value === "number" ? value : Number.parseFloat(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function getSidebarAssets(response) {
+  if (!response)
+    return [];
+  if (Array.isArray(response))
+    return response;
+  return response.data ?? [];
+}
 var getDashboardOverviewSchema = z9.object({});
 async function getDashboardOverview(_input, client) {
   try {
+    const overviewPromise = client.get("/api/dashboard/overview-metrics").catch(() => null);
+    const sidebarPromise = client.get(
+      "/api/dashboard/sidebar-assets"
+    ).catch(() => null);
     const [overviewResponse, sidebarResponse] = await Promise.all([
-      client.get("/api/dashboard/overview-metrics").catch(() => null),
-      client.get("/api/dashboard/sidebar-assets").catch(() => null)
+      overviewPromise,
+      sidebarPromise
     ]);
-    const overview = overviewResponse?.data || overviewResponse || {};
-    const sidebarAssets = sidebarResponse?.data || sidebarResponse || [];
-    const apps = Array.isArray(sidebarAssets) ? sidebarAssets : [];
-    const totalValuation = apps.reduce((sum, a) => {
-      return sum + parseFloat(a.currentValuation || "0");
+    const overview = overviewResponse?.data ?? overviewResponse ?? {};
+    const apps = getSidebarAssets(sidebarResponse);
+    const totalValuation = apps.reduce((sum, app) => {
+      return sum + (parseDashboardNumber(app.currentValuation) ?? 0);
     }, 0);
     return {
       content: [
@@ -1168,16 +1299,16 @@ async function getDashboardOverview(_input, client) {
             portfolio: {
               totalApps: apps.length,
               totalValuation: totalValuation > 0 ? totalValuation : null,
-              apps: apps.map((a) => ({
-                id: a.id,
-                name: a.name,
-                bundleId: a.bundleId,
-                platform: a.appleAppId ? "ios" : a.googleAppId ? "android" : "unknown",
-                currentValuation: a.currentValuation ? parseFloat(a.currentValuation) : null,
-                rating: a.rating ? parseFloat(a.rating) : null,
-                ratingCount: a.ratingCount || null,
-                category: a.category || null,
-                iconUrl: a.iconUrl || null
+              apps: apps.map((app) => ({
+                id: app.id,
+                name: app.name,
+                bundleId: app.bundleId,
+                platform: app.appleAppId ? "ios" : app.googleAppId ? "android" : "unknown",
+                currentValuation: parseDashboardNumber(app.currentValuation),
+                rating: parseDashboardNumber(app.rating),
+                ratingCount: app.ratingCount ?? null,
+                category: app.category ?? null,
+                iconUrl: app.iconUrl ?? null
               }))
             },
             overview
@@ -1200,13 +1331,15 @@ async function getDashboardOverview(_input, client) {
 
 // src/tools/actions.ts
 import { z as z10 } from "zod";
+function asRecord2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
 var listPendingActionsSchema = z10.object({
   assetId: z10.string().uuid().optional().describe("Filter by app UUID"),
   limit: z10.number().int().min(1).max(100).default(50).describe("Maximum number of actions to return")
 });
 var approveActionSchema = z10.object({
-  actionId: z10.string().describe("The draft reply ID to approve"),
-  editedReply: z10.string().optional().describe("Optionally modify the reply text before approving")
+  actionId: z10.string().describe("The pending action ID to approve")
 });
 var rejectActionSchema = z10.object({
   actionId: z10.string().describe("The draft reply ID to reject/delete")
@@ -1216,10 +1349,16 @@ async function listPendingActions(input, client) {
     const params = {
       limit: input.limit
     };
-    if (input.assetId)
-      params.assetId = input.assetId;
-    const response = await client.get("/api/pending-actions", params);
-    const actions = response.data || response.actions || [];
+    const response = await client.get(
+      "/api/pending-actions",
+      params
+    );
+    let actions = response.data ?? response.actions ?? [];
+    if (input.assetId) {
+      actions = actions.filter(
+        (action) => action.assetId === input.assetId
+      );
+    }
     return {
       content: [
         {
@@ -1245,10 +1384,10 @@ async function listPendingActions(input, client) {
 }
 async function approveAction(input, client) {
   try {
-    const body = {};
-    if (input.editedReply)
-      body.editedReply = input.editedReply;
-    const response = await client.post(`/api/pending-actions/${input.actionId}/approve`, body);
+    const response = await client.post(
+      `/api/pending-actions/${input.actionId}/approve`,
+      {}
+    );
     return {
       content: [
         {
@@ -1258,7 +1397,7 @@ async function approveAction(input, client) {
             actionId: input.actionId,
             status: "approved",
             message: "Reply has been approved and queued for sending",
-            ...response.data || {}
+            ...asRecord2(response.data)
           })
         }
       ]
@@ -1277,7 +1416,9 @@ async function approveAction(input, client) {
 }
 async function rejectAction(input, client) {
   try {
-    const response = await client.post(`/api/pending-actions/${input.actionId}/reject`);
+    const response = await client.post(
+      `/api/pending-actions/${input.actionId}/reject`
+    );
     return {
       content: [
         {
@@ -1287,7 +1428,7 @@ async function rejectAction(input, client) {
             actionId: input.actionId,
             status: "rejected",
             message: "Draft reply has been rejected and removed",
-            ...response.data || {}
+            ...asRecord2(response.data)
           })
         }
       ]
@@ -1321,10 +1462,13 @@ var getAsoExperimentsSchema = z11.object({
   assetId: z11.string().uuid().describe("App UUID to list ASO experiments for"),
   status: z11.enum(["proposed", "approved", "applied", "measuring", "completed", "reverted"]).optional().describe("Filter experiments by status"),
   limit: z11.number().int().min(1).max(100).default(20).describe("Maximum number of experiments to return"),
-  offset: z11.number().int().min(0).default(0).describe("Number of experiments to skip for pagination")
+  cursor: z11.string().optional().describe("Pagination cursor from a previous response (meta.nextCursor)")
 });
 var getAsoLocaleSnapshotsSchema = z11.object({
-  assetId: z11.string().uuid().describe("App UUID to get locale snapshots for")
+  assetId: z11.string().uuid().describe("App UUID to get locale snapshots for"),
+  store: z11.enum(["ios", "android"]).default("ios").describe("Which store listing to read"),
+  locale: z11.string().optional().describe('Filter to a single locale (e.g. "en-US"). Returns all locales if omitted.'),
+  limit: z11.number().int().min(1).max(500).optional().describe("Maximum snapshot rows to return (newest first)")
 });
 var triggerAsoAnalysisSchema = z11.object({
   assetId: z11.string().uuid().describe("App UUID to trigger ASO analysis for")
@@ -1405,7 +1549,7 @@ async function getAsoExperiments(input, client) {
   try {
     const params = {
       limit: input.limit,
-      offset: input.offset
+      cursor: input.cursor
     };
     if (input.status)
       params.status = input.status;
@@ -1432,7 +1576,14 @@ async function getAsoExperiments(input, client) {
 }
 async function getAsoLocaleSnapshots(input, client) {
   try {
-    const response = await client.get(`/api/assets/${input.assetId}/aso/locale-snapshots`);
+    const response = await client.get(
+      `/api/assets/${input.assetId}/aso/listing-snapshots`,
+      {
+        store: input.store,
+        locale: input.locale,
+        limit: input.limit
+      }
+    );
     return {
       content: [
         {
@@ -1455,7 +1606,10 @@ async function getAsoLocaleSnapshots(input, client) {
 }
 async function triggerAsoAnalysis(input, client) {
   try {
-    const response = await client.post(`/api/assets/${input.assetId}/aso/analyze`);
+    const response = await client.post(
+      `/api/assets/${input.assetId}/aso/refetch`,
+      { force: true }
+    );
     return {
       content: [
         {
@@ -1478,6 +1632,7 @@ async function triggerAsoAnalysis(input, client) {
 }
 
 // src/tools/chat.ts
+import { randomUUID } from "node:crypto";
 import { z as z12 } from "zod";
 var listConversationsSchema = z12.object({
   limit: z12.number().int().min(1).max(100).default(20).describe("Maximum number of conversations to return")
@@ -1547,23 +1702,81 @@ async function getConversationMessages(input, client) {
     };
   }
 }
+function parseUiMessageStream(raw) {
+  let reply = "";
+  const toolsUsed = [];
+  for (const line of raw.split("\n")) {
+    if (!line.startsWith("data:"))
+      continue;
+    const payload = line.slice(5).trim();
+    if (!payload || payload === "[DONE]")
+      continue;
+    try {
+      const event = JSON.parse(payload);
+      if (event.type === "text-delta") {
+        reply += String(event.delta ?? event.textDelta ?? "");
+      } else if (typeof event.type === "string" && event.type === "tool-input-start" && typeof event.toolName === "string") {
+        toolsUsed.push(event.toolName);
+      }
+    } catch {
+    }
+  }
+  return { reply, toolsUsed };
+}
 async function sendChatMessage(input, client) {
   try {
+    const conversationId = input.conversationId ?? randomUUID();
+    let priorMessages = [];
+    if (input.conversationId) {
+      const history = await client.get(`/api/chat/messages/${input.conversationId}`, { limit: 1e3 });
+      for (const message of history.data ?? []) {
+        const textParts = (message.parts ?? []).filter(
+          (part) => part.type === "text" && typeof part.text === "string"
+        );
+        if (textParts.length === 0)
+          continue;
+        priorMessages.push({
+          id: message.id,
+          role: message.role,
+          parts: textParts
+        });
+      }
+      priorMessages = priorMessages.slice(-100);
+    }
     const body = {
-      message: input.message
+      id: conversationId,
+      messages: [
+        ...priorMessages,
+        {
+          id: randomUUID(),
+          role: "user",
+          parts: [{ type: "text", text: input.message }]
+        }
+      ]
     };
-    if (input.conversationId)
-      body.conversationId = input.conversationId;
-    if (input.agentType)
-      body.agentType = input.agentType;
-    const response = await client.post("/api/chat", body);
+    if (input.agentType) {
+      body.agentContext = {
+        agentId: null,
+        agentType: input.agentType,
+        agentName: input.agentType,
+        surface: "mcp"
+      };
+    }
+    const raw = await client.postStream("/api/chat", body);
+    const { reply, toolsUsed } = parseUiMessageStream(raw);
     return {
       content: [
         {
           type: "text",
-          text: formatAsJson(response.data || response)
+          text: formatAsJson({
+            conversationId,
+            reply: reply || "The assistant returned no text response.",
+            toolsUsed,
+            tip: "Pass this conversationId to continue the conversation or to get_conversation_messages for the full transcript."
+          })
         }
-      ]
+      ],
+      ...reply ? {} : { isError: true }
     };
   } catch (error) {
     return {
@@ -1581,8 +1794,8 @@ async function sendChatMessage(input, client) {
 // src/tools/index.ts
 function registerTools(server, client, options = {}) {
   const rateLimiter = options.rateLimiter ?? new RateLimiter(100, 6e4);
-  function wrapTool(_toolName, handler) {
-    return async (input) => {
+  function wrapTool(handler) {
+    const callback = async (input) => {
       const rateCheck = rateLimiter.check("default");
       if (!rateCheck.allowed) {
         return {
@@ -1599,6 +1812,7 @@ function registerTools(server, client, options = {}) {
       }
       return handler(input, client);
     };
+    return callback;
   }
   function tool(name, title, description, schema, handler, annotations) {
     server.registerTool(
@@ -1609,8 +1823,7 @@ function registerTools(server, client, options = {}) {
         inputSchema: schema.shape,
         annotations: { title, ...annotations }
       },
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      wrapTool(name, handler)
+      wrapTool(handler)
     );
   }
   tool(
@@ -1656,7 +1869,7 @@ function registerTools(server, client, options = {}) {
   tool(
     "translate_review",
     "Translate review",
-    "Translate a review to English. Useful for reviews written in other languages. Returns the translated text. Does not modify the review in Fload.",
+    "Translate a review to English. Useful for reviews written in other languages. Pass the review content fields (rating, title, body, storeFront, appVersionString) from a get_reviews result. Returns the translated text. Does not modify the review in Fload.",
     translateReviewSchema,
     translateReview,
     { readOnlyHint: true, openWorldHint: true }
@@ -1800,7 +2013,7 @@ function registerTools(server, client, options = {}) {
   tool(
     "get_forecasts",
     "Get forecasts",
-    "Get valuation-based forecasts and trend analysis for an app. Returns historical valuation data points, trend statistics (direction, volatility), and simple linear projections. For detailed metric forecasting with statistical models, use the platform dashboard.",
+    "Get a statistical forecast for an app metric (proceeds, total_revenue, total_downloads, active_subs, or new_trials). Returns weekly historical values plus a forward projection with confidence bounds.",
     getForecastsSchema,
     getForecasts,
     { readOnlyHint: true, openWorldHint: false }
@@ -1923,6 +2136,29 @@ async function createMcpServer(_config, client) {
   return server;
 }
 
+// src/public-errors.ts
+var INTERNAL_ERROR_PATTERNS = [
+  /\b(stack|trace|at\s+[\w.$<>]+\s*\()/i,
+  /\b(sql|postgres|drizzle|database|constraint|duplicate key|violates|relation)\b/i,
+  /\b(fetch|undici|socket|ECONNRESET|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|HTTP\s+\d{3})\b/i,
+  /\b(token|secret|api[_-]?key|authorization|bearer|cookie|password)\b/i,
+  /\b[a-z0-9]+_(secret|token|key)\b/i,
+  /\b(secret|token|key)[_-][a-z0-9]+\b/i,
+  /\b(scrap|browser|patchright|playwright|chromium|page\.|locator|selector)\b/i,
+  /\b(redis|bullmq|queue|job id|worker)\b/i
+];
+function looksInternal(message) {
+  return INTERNAL_ERROR_PATTERNS.some((pattern) => pattern.test(message));
+}
+function publicMcpErrorMessage(message, fallbackMessage = "Fload could not complete the request. Please try again.") {
+  const raw = message instanceof Error ? message.message : typeof message === "string" ? message : "";
+  const normalized = raw.replace(/\s+/g, " ").trim();
+  if (!normalized || normalized.length > 180 || looksInternal(normalized)) {
+    return fallbackMessage;
+  }
+  return normalized;
+}
+
 // src/api-client.ts
 var FloadApiClient = class {
   constructor(baseUrl, apiKey) {
@@ -1931,17 +2167,22 @@ var FloadApiClient = class {
   }
   async request(path, options = {}) {
     const url = `${this.baseUrl}${path}`;
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      ...options.body ? { "Content-Type": "application/json" } : {},
+      ...options.headers
+    };
     const response = await fetch(url, {
       ...options,
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json",
-        ...options.headers
-      }
+      headers
     });
     if (!response.ok) {
       const error = await response.json().catch(() => ({ message: response.statusText }));
-      throw new Error(error.message || `API error: ${response.status}`);
+      const safeError = publicMcpErrorMessage(
+        error.publicMessage || error.message || response.statusText,
+        response.status >= 500 ? "Fload could not complete the request. Please try again." : "Fload rejected the request. Please check access and try again."
+      );
+      throw new Error(safeError);
     }
     return response.json();
   }
@@ -1971,6 +2212,31 @@ var FloadApiClient = class {
   async delete(path) {
     return this.request(path, { method: "DELETE" });
   }
+  /**
+   * POST to a streaming endpoint (SSE / AI SDK UI-message stream) and
+   * return the raw response body as text. Callers parse the event lines.
+   */
+  async postStream(path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        Accept: "text/event-stream"
+      },
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      const safeError = publicMcpErrorMessage(
+        error.publicMessage || error.message || response.statusText,
+        response.status >= 500 ? "Fload could not complete the request. Please try again." : "Fload rejected the request. Please check access and try again."
+      );
+      throw new Error(safeError);
+    }
+    return response.text();
+  }
 };
 
 // src/bin.ts