mcp-scraper 0.3.46 → 0.3.47

package/dist/bin/api-server.cjs

@@ -10288,8 +10288,8 @@ var init_rates = __esm({
         label: "Video breakdown (frame-by-frame + transcript)",
         aliases: ["video_frame_analysis", "video breakdown", "video analysis", "analyze video"],
         credits: mcToCredits(MC_COSTS.video_analysis),
-        unit: "per video",
-        notes: "Full multi-lens video breakdown: samples up to 120 frames across a video (to 30 min), analyzes each with vision AI, transcribes the audio, then produces summary, pacing/energy, words-per-minute, topic outline, key points, hook analysis, visual style, and a how-to-replicate recipe with a quality-control pass. Flat $1 per video; refunded if the run fails."
+        unit: "per 120 frames (max 480)",
+        notes: "Full multi-lens video breakdown: samples frames across a video (up to 30 minutes), analyzes each with vision AI, transcribes the audio, then produces summary, pacing/energy, words-per-minute, topic outline, key points, hook analysis, visual style, and a how-to-replicate recipe with a quality-control pass. $1 per 120 frames requested (max 480 = $4); billed down automatically if the video cannot use the requested frames, and refunded fully if the run fails."
       }
     ];
     CONCURRENCY_PRICE_ID = "price_1Ta1NRS8aAcsk3TGwsRnYbix";
@@ -10365,6 +10365,7 @@ var init_rates = __esm({
       REDDIT_THREAD_REFUND: "reddit_thread_refund",
       VIDEO_ANALYSIS: "video_analysis",
       VIDEO_ANALYSIS_REFUND: "video_analysis_refund",
+      VIDEO_ANALYSIS_ADJUST: "video_analysis_adjust",
       MEMORY_AI: "memory_ai",
       MEMORY_AI_REFUND: "memory_ai_refund"
     };
@@ -16657,6 +16658,9 @@ var init_memory = __esm({
 function invalidRequest5(message) {
   return { error_code: "invalid_request", message };
 }
+function tiersFor(frames) {
+  return Math.ceil(Math.min(Math.max(frames, 1), 480) / 120);
+}
 var import_hono9, import_zod20, videoApp, AnalyzeBodySchema;
 var init_video_routes = __esm({
   "src/api/video-routes.ts"() {
@@ -16671,7 +16675,7 @@ var init_video_routes = __esm({
     AnalyzeBodySchema = import_zod20.z.object({
       sourceUrl: import_zod20.z.string().trim().url("sourceUrl must be a direct video file URL"),
       intervalS: import_zod20.z.number().min(1).max(30).optional(),
-      maxFrames: import_zod20.z.number().int().min(1).max(120).optional(),
+      maxFrames: import_zod20.z.number().int().min(1).max(480).optional(),
       detail: import_zod20.z.enum(["fast", "standard", "deep"]).optional(),
       vault: import_zod20.z.string().trim().min(1).optional()
     });
@@ -16682,21 +16686,24 @@ var init_video_routes = __esm({
       const user = c.get("user");
       const { key: memKey, error: memErr } = await getOrCreateUserMemoryKey(user);
       if (!memKey) return c.json({ error_code: "memory_unavailable", message: memErr ?? "memory unavailable" }, 502);
-      const { ok, balance_mc } = await debitMc(user.id, MC_COSTS.video_analysis, LedgerOperation.VIDEO_ANALYSIS, body.sourceUrl);
-      if (!ok) return c.json(insufficientBalanceResponse(balance_mc, MC_COSTS.video_analysis), 402);
+      const requestedFrames = Math.min(Math.max(body.maxFrames ?? 120, 1), 480);
+      const tiers = tiersFor(requestedFrames);
+      const holdMc = tiers * MC_COSTS.video_analysis;
+      const { ok, balance_mc } = await debitMc(user.id, holdMc, LedgerOperation.VIDEO_ANALYSIS, body.sourceUrl);
+      if (!ok) return c.json(insufficientBalanceResponse(balance_mc, holdMc), 402);
       const started = await memoryCall(
         "videoAnalyzeStartTool",
         {
           sourceUrl: body.sourceUrl,
           intervalS: body.intervalS ?? 2,
-          maxFrames: body.maxFrames ?? 120,
+          maxFrames: requestedFrames,
           detail: body.detail ?? "standard",
           vault: body.vault ?? "Library"
         },
         memKey
       );
       if (!started.ok || !started.runId) {
-        await creditMc(user.id, MC_COSTS.video_analysis, LedgerOperation.VIDEO_ANALYSIS_REFUND, `start-failed:${body.sourceUrl}`);
+        await creditMc(user.id, holdMc, LedgerOperation.VIDEO_ANALYSIS_REFUND, `start-failed:${body.sourceUrl}`);
         return c.json({ error_code: "video_start_failed", message: started.error ?? "could not start analysis" }, 502);
       }
       return c.json({
@@ -16715,11 +16722,30 @@ var init_video_routes = __esm({
       if (!memKey) return c.json({ error_code: "memory_unavailable", message: memErr ?? "memory unavailable" }, 502);
       const st = await memoryCall("videoAnalyzeStatusTool", { runId }, memKey);
       if (!st.ok) return c.json({ error_code: "not_found", message: st.error ?? "run not found" }, 404);
+      const requestedTiers = tiersFor(st.maxFrames ?? 120);
+      let reconciliation = null;
       if (st.status === "failed") {
+        const refundMc = requestedTiers * MC_COSTS.video_analysis;
         const refundOp = `${LedgerOperation.VIDEO_ANALYSIS_REFUND}:${runId}`;
         if (!await ledgerExistsForOperation(user.id, refundOp)) {
-          await creditMc(user.id, MC_COSTS.video_analysis, refundOp, `run-failed:${runId}`);
+          await creditMc(user.id, refundMc, refundOp, `run-failed:${runId}`);
+        }
+        reconciliation = { billedMc: requestedTiers * MC_COSTS.video_analysis, refundedMc: refundMc, effectiveFrames: null };
+      }
+      if (st.status === "done") {
+        const effectiveTiers = tiersFor(st.frameCount ?? 120);
+        const diff = requestedTiers - effectiveTiers;
+        if (diff > 0) {
+          const adjustOp = `${LedgerOperation.VIDEO_ANALYSIS_ADJUST}:${runId}`;
+          if (!await ledgerExistsForOperation(user.id, adjustOp)) {
+            await creditMc(user.id, diff * MC_COSTS.video_analysis, adjustOp, `tier-reconcile:${runId}`);
+          }
         }
+        reconciliation = {
+          billedMc: requestedTiers * MC_COSTS.video_analysis,
+          refundedMc: Math.max(diff, 0) * MC_COSTS.video_analysis,
+          effectiveFrames: st.frameCount ?? null
+        };
       }
       return c.json({
         ok: true,
@@ -16728,7 +16754,8 @@ var init_video_routes = __esm({
         progress: st.progress ?? null,
         frameCount: st.frameCount ?? null,
         ...st.status === "done" ? { artifactPath: st.artifactPath ?? null, report: st.report ?? null } : {},
-        ...st.error ? { error: st.error } : {}
+        ...st.error ? { error: st.error } : {},
+        ...reconciliation ? { reconciliation } : {}
       });
     });
   }
@@ -26003,7 +26030,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.3.46";
+    PACKAGE_VERSION = "0.3.47";
   }
 });
 
@@ -26199,7 +26226,7 @@ var init_mcp_tool_schemas = __esm({
     VideoFrameAnalysisInputSchema = {
       sourceUrl: import_zod31.z.string().min(1).describe("A DIRECT video file URL (.mp4/.webm/.mov). Not a YouTube/Facebook/Instagram page URL \u2014 resolve those to a direct media URL first. Videos up to 30 minutes are supported."),
       intervalS: import_zod31.z.number().min(1).max(30).optional().describe("Preferred seconds between sampled frames (1-30, default 2). Automatically widened for long videos so the whole duration is covered within the frame budget."),
-      maxFrames: import_zod31.z.number().int().min(1).max(120).optional().describe("Max frames analyzed (<=120, default 120). Frames are spread evenly across the whole video."),
+      maxFrames: import_zod31.z.number().int().min(1).max(480).optional().describe("Max frames analyzed (<=480, default 120). $1 per 120 frames requested \u2014 120=$1 \u2026 480=$4 \u2014 automatically refunded down if the video cannot use them (minimum 1s between frames). Frames are spread evenly across the whole video."),
       detail: import_zod31.z.enum(["fast", "standard", "deep"]).optional().describe("Analysis depth. Default standard."),
       vault: import_zod31.z.string().min(1).optional().describe('Memory vault to save the finished breakdown into. Default "Library".')
     };
@@ -26662,7 +26689,12 @@ var init_mcp_tool_schemas = __esm({
       frameCount: import_zod31.z.number().int().nullable().optional(),
       artifactPath: NullableString,
       report: NullableString,
-      error: NullableString
+      error: NullableString,
+      reconciliation: import_zod31.z.object({
+        billedMc: import_zod31.z.number().int(),
+        refundedMc: import_zod31.z.number().int(),
+        effectiveFrames: import_zod31.z.number().int().nullable()
+      }).nullable().optional()
     };
     RedditThreadOutputSchema = {
       sourceUrl: NullableString,
@@ -27555,14 +27587,14 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => formatRedditThread(await executor.redditThread(input), input));
   server.registerTool("video_frame_analysis", {
     title: "Video Breakdown (frame-by-frame + transcript)",
-    description: "Produce a deep frame-by-frame + transcript breakdown of a video \u2014 pacing, hook, visual style, and how to replicate it. Pass a DIRECT video file URL (.mp4/.webm/.mov), not a page URL. Runs asynchronously and costs a flat $1 (refunded on failure): returns a runId immediately; poll video_frame_analysis_status until done.",
+    description: "Produce a deep frame-by-frame + transcript breakdown of a video \u2014 pacing, hook, visual style, and how to replicate it. Pass a DIRECT video file URL (.mp4/.webm/.mov), not a page URL. Costs $1 per 120 frames requested (max 480 = $4; refunded down if the video can't use them; refunded fully on failure): returns a runId immediately; poll video_frame_analysis_status until done. Videos up to 30 minutes.",
     inputSchema: VideoFrameAnalysisInputSchema,
     outputSchema: recordOutputSchema("video_frame_analysis", VideoFrameAnalysisOutputSchema),
     annotations: { title: "Video Breakdown", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
   }, async (input) => executor.videoFrameAnalysis(input));
   server.registerTool("video_frame_analysis_status", {
     title: "Video Breakdown Status",
-    description: 'Check progress of a video breakdown started with video_frame_analysis, using its runId. Free to call. When status is "done" it returns the full report and vault path; stop polling on "done" or "failed".',
+    description: 'Check progress of a video breakdown started with video_frame_analysis, using its runId. Free to call. When status is "done" it returns the full report and vault path; stop polling on "done" or "failed". Reports the billed tier reconciliation when done.',
     inputSchema: VideoFrameAnalysisStatusInputSchema,
     outputSchema: recordOutputSchema("video_frame_analysis_status", VideoFrameAnalysisStatusOutputSchema),
     annotations: { title: "Video Breakdown Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }