@productmaker/mcp 2.1.0 → 2.2.0

package/dist/http.js

@@ -153,7 +153,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "2.1.0";
+var MCP_VERSION = "2.2.0";
 
 // src/tools/tasks.ts
 import { z as z40 } from "zod";
@@ -1424,11 +1424,12 @@ var IngestOptions = z13.object({
   *  shorter than the generated angle count leaves the remaining positions
   *  auto-selected. Empty/omitted → all angles auto-select as before. */
   angleNarratives: z13.array(NarrativeStyle).max(3).optional(),
-  // 720p is the recommended default for every tier (flipped 2026-06-22 — grok provider
-  // unified per-second pricing, so 720p is only a small premium and worth the sharpness).
+  // 480p is the recommended default for every tier (flipped back 2026-07-30 — the
+  // 720p premium is real but small, and users on the entry plan were defaulting
+  // into it while burning half a month of credits on one video).
   // This Zod default is what callers that omit the field (MCP/API) actually get,
-  // so it must agree with resolveSingleCallAwareResolution's unset fallback (720p).
-  videoResolution: VideoResolution.default("720p"),
+  // so it must agree with resolveSingleCallAwareResolution's unset fallback (480p).
+  videoResolution: VideoResolution.default("480p"),
   generateAdCopy: z13.boolean().default(true),
   generateAiMusic: z13.boolean().optional(),
   voiceId: VoiceId.optional(),
@@ -1543,9 +1544,9 @@ var IngestResumePayload = z13.object({
   videoModel: VideoModel.default("veo"),
   videoTier: VideoTier.optional(),
   narrativeStyle: NarrativeStyle.default("review"),
-  // 720p is the recommended default for every tier (flipped 2026-06-22) — keep in sync
-  // with IngestOptions.videoResolution and resolveSingleCallAwareResolution.
-  videoResolution: VideoResolution.default("720p"),
+  // 480p is the recommended default for every tier (flipped back 2026-07-30) — keep in
+  // sync with IngestOptions.videoResolution and resolveSingleCallAwareResolution.
+  videoResolution: VideoResolution.default("480p"),
   pauseForVideoScriptReview: z13.boolean().optional(),
   generateAiMusic: z13.boolean().optional(),
   scriptNotes: z13.string().max(2e3).optional(),
@@ -5004,16 +5005,37 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.15,
     userPriceCents: 0.3
   },
-  // Video QA — independent anatomy arm-scanner (Gemini 3 Flash Preview, one call per
-  // sampled frame, up to ARM_SCAN_MAX_FRAMES per clip). Billed PER FRAME (units: 1 per
-  // call), so this rate is per frame, not per clip. Sized above the 30d prod average
-  // (10.303 entries at $6.81 our => 0.066¢/frame) so the fallback path — used when
-  // OpenRouter omits usage.cost — cannot under-charge. Before this key existed those
-  // fallbacks hit the `No pricing rule found; skipping` branch and went UNBILLED.
+  // Video QA — anatomy. THREE keys, and they do NOT share a unit. Getting this wrong
+  // over-charges by ~42x, which is exactly what a first pass at the 2026-07-30 change did.
+  //
+  // (a) The arm-scan's per-FRAME counting sweep. STILL LIVE on the whole-video concat path
+  //     (`scanClipArms` at apps/api/src/workers/core/video-concat-core.ts), which bills
+  //     units:1 PER SAMPLED FRAME, up to ARM_SCAN_FRAME_CEILING. Rate must stay per-frame.
+  //     Sized above the 30d prod average (10303 rows => 0.132c user/frame).
   "openrouter:video-anatomy-arm-scan": {
     ourCostCents: 0.1,
     userPriceCents: 0.2
   },
+  // (b) The frame JUDGE that replaced the sweep on the `analyzeVideoClipDJ` path: ALL frames
+  //     in ONE multi-image call, so a unit is one call. MEASURED, not estimated —
+  //     usage.cost on a real 16-frame judgement at 768px is $0.0417 => 4.17c our. The table is
+  //     the FALLBACK used when OpenRouter omits usage.cost, so it must sit at or above that.
+  //     Billed PER FRAME (units = frames in the call), like the sweep and for the same reason:
+  //     the cost scales with IMAGES and QA_FRAME_JUDGE_FRAMES is env-overridable, so a per-CALL
+  //     unit would freeze the fallback charge and the credit-gate quote at the cap the rate
+  //     happened to be measured at. Measured $0.0417 over 16 frames => 0.26c/frame; priced at
+  //     0.32c for headroom (n=1 on one clip, and the 1.9k reasoning-token share moves with
+  //     QA_DETECTOR_EFFORT). Re-derive from 30d of BillingEntry once this key has volume.
+  "openrouter:video-qa-anatomy-frame-judge": {
+    ourCostCents: 0.32,
+    userPriceCents: 0.64
+  },
+  // (c) Tracing confirmation of a frames-only finding: 3 stills + a 3s 480p slice, one call,
+  //     no 16-image prompt — materially cheaper than the judgement it verifies.
+  "openrouter:video-qa-anatomy-tracing-confirm": {
+    ourCostCents: 1.5,
+    userPriceCents: 3
+  },
   // Physics confirmation — skeptical second opinion on D+J floating-object flags
   // (Gemini 3 Flash Preview, ~3 frames per flagged moment, 1 call). Aligned with other vision-QA keys.
   "openrouter:video-physics-confirmation": {
@@ -6566,6 +6588,36 @@ var DropshippingProjectStatusSchema = z37.enum([
   "completed",
   "archived"
 ]);
+var DROPSHIPPING_LAUNCH_REWARD_CAMPAIGN = "dropshipping-launch-v1";
+var DropshippingRewardMilestoneSchema = z37.enum([
+  "product_selected",
+  "costing_saved",
+  "product_media_ready",
+  "creatives_completed",
+  "campaign_created"
+]);
+var DROPSHIPPING_LAUNCH_REWARD_CREDITS = {
+  product_selected: 50,
+  costing_saved: 50,
+  product_media_ready: 50,
+  creatives_completed: 150,
+  campaign_created: 200
+};
+var DROPSHIPPING_LAUNCH_REWARD_TOTAL_CREDITS = Object.values(DROPSHIPPING_LAUNCH_REWARD_CREDITS).reduce((sum, credits) => sum + credits, 0);
+var DropshippingProjectRewardMilestoneStateSchema = z37.object({
+  milestone: DropshippingRewardMilestoneSchema,
+  credits: z37.number().int().positive(),
+  available: z37.boolean().optional(),
+  earned: z37.boolean(),
+  grantId: z37.string().uuid().nullable(),
+  grantedAt: z37.string().datetime().nullable()
+});
+var DropshippingProjectRewardProgressSchema = z37.object({
+  campaignKey: z37.literal(DROPSHIPPING_LAUNCH_REWARD_CAMPAIGN),
+  totalCredits: z37.number().int().positive(),
+  earnedCredits: z37.number().int().nonnegative(),
+  milestones: z37.array(DropshippingProjectRewardMilestoneStateSchema).length(DropshippingRewardMilestoneSchema.options.length)
+});
 var DropshippingProjectPhaseSchema = z37.enum([
   "research",
   "costing",
@@ -6723,6 +6775,7 @@ var DropshippingProjectResponseSchema = z37.object({
   version: z37.number().int().positive(),
   phase: DropshippingProjectPhaseSchema,
   nextAction: DropshippingProjectNextActionSchema.nullable(),
+  rewards: DropshippingProjectRewardProgressSchema,
   createdAt: z37.string().datetime(),
   updatedAt: z37.string().datetime()
 });
@@ -6789,7 +6842,7 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "create_product_task",
     confirmation: "credit_consuming",
-    schemaHash: "828ee643bb3a05a63c6e63730459d35ce1621cbd559bbc76a6c5fcec9a45654d"
+    schemaHash: "5b19f7c6dfdc55b0c472df045e24fe73aa134624a141b63342bfbd3bbb0d043b"
   },
   {
     name: "edit_task_draft",
@@ -6814,17 +6867,17 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "generate_image_creatives",
     confirmation: "credit_consuming",
-    schemaHash: "fb6afcf8571887906340fa0b8dd17196d2814e480b734ad5d374e8810958152e"
+    schemaHash: "82b520e8001e9c57ab0a89d9d66ea5dfc92e6306eed302edfe1005cee5025fbf"
   },
   {
     name: "generate_landing",
     confirmation: "credit_consuming",
-    schemaHash: "539922b8fe611c73a7349b1c3f92632fe21f161d7874a0ef2172abfec5834759"
+    schemaHash: "23f0c56dc719235e51d16fd61a9703b64fa6d300356ffbf6b21d703324b0bb18"
   },
   {
     name: "generate_video_creative",
     confirmation: "credit_consuming",
-    schemaHash: "94e90d60ad5d68538c31d880a635c5be69d6d204fd2119139735af83ebf0b94a"
+    schemaHash: "79d3ec9310885b482d62c94a27e9c039833c0619d9332a593fe7d32a60ae1388"
   },
   {
     name: "get_meta_campaign_status",
@@ -8107,7 +8160,7 @@ var CreateProductTaskInput = z40.object({
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo del video: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
   pauseForAngleReview: z40.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. \xDAsalo si quiere decidir 15/30s cuando aparezca un winner. Default false."),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista" para 15s; al pedir durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
-  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez (~el doble de precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   multiAngleVideos: z40.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
   angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar". angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para varios \xE1ngulos.'),
   outputs: z40.array(z40.enum([
@@ -8582,6 +8635,7 @@ var CreativeRefs = {
   isCombo: z41.boolean().optional().describe("Opcional. Si true, el creativo presenta el producto como combo/pack. Default false."),
   competitorScanEnabled: z41.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z41.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer el creativo."),
+  projectId: z41.string().uuid().optional().describe("Opcional. ID de un proyecto guiado de dropshipping activo del usuario. Enlaza esta generaci\xF3n con su progreso y recompensas."),
   creativeDirection: z41.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Aplica SOLO a im\xE1genes y landing. Ej. im\xE1genes: "amarillo, azul y rojo, minimalista"; landing: "elegante, paleta fr\xEDa". Para video usa scriptNotes (ambiente/escenario). M\xE1x 500 caracteres.')
 };
 var VideoInput = z41.object({
@@ -8601,7 +8655,7 @@ var VideoInput = z41.object({
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Los presets funcionan a 15s y 30s. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (una regla visual experimental original), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla).'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista"; para durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
-  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "720p" = m\xE1xima nitidez (RECOMENDADO, default si se omite); "480p" = render m\xE1s econ\xF3mico. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p).'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   features: z41.array(z41.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
   price: CreativeRefs.price,
   offer: CreativeRefs.offer,
@@ -8612,7 +8666,8 @@ var VideoInput = z41.object({
   pauseForVideoScriptReview: z41.boolean().optional().describe("Opcional. Si true, la tarea pausa despu\xE9s de generar el guion y antes de renderizar. \xDAsalo cuando el usuario quiera editar el guion antes de gastar cr\xE9ditos en el video. Tras la pausa: get_video_script para leerlo, approve_video_script para aprobar (con o sin ediciones). Default false."),
   pauseForAngleReview: z41.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. Default false."),
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
-  brandId: CreativeRefs.brandId
+  brandId: CreativeRefs.brandId,
+  projectId: CreativeRefs.projectId
 }).strict();
 var FreeVideoQualityEnum = z41.enum([
   "economical",
@@ -8676,6 +8731,7 @@ var ImageInput = z41.object({
   isCombo: CreativeRefs.isCombo,
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
+  projectId: CreativeRefs.projectId,
   creativeDirection: CreativeRefs.creativeDirection
 });
 var LandingInput = z41.object({
@@ -8693,6 +8749,7 @@ var LandingInput = z41.object({
   isCombo: CreativeRefs.isCombo,
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
+  projectId: CreativeRefs.projectId,
   creativeDirection: CreativeRefs.creativeDirection,
   landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".'),
   landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
@@ -8732,7 +8789,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
     try {
       const resolved = resolveVideoPreset(input.videoPreset);
       const wireTier = resolveWireVideoTier(input.videoTier, input.durationSeconds);
-      const { videoTier: _publicTier, videoResolution: _vr, ...rest } = input;
+      const { videoTier: _publicTier, videoResolution: _vr, projectId, ...rest } = input;
       const wirePayload = {
         ...rest
       };
@@ -8742,6 +8799,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       }
       wirePayload.videoTier = wireTier;
       if (input.videoResolution) wirePayload.videoResolution = input.videoResolution;
+      if (projectId) wirePayload.dropshippingProjectId = projectId;
       return await submitCreative(api, {
         path: "/v1/creatives/videos",
         estimatedSeconds: 300,
@@ -8754,10 +8812,16 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
   });
   server.tool("generate_image_creatives", 'Genera N variantes de imagen creativa (ads est\xE1ticos). Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), productTitle, primaryAngle, language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario:\n- price y offer (se renderizan en la imagen \u2014 nunca los asumas; si dice "t\xFA elige", om\xEDtelos).\n- compareAtPrice si hay descuento (ej. "$129.000" para tachar).\n- creativeArchetype y visualTreatment si quiere un look espec\xEDfico (performance vs premium DTC). Si no le importa, om\xEDtelos.\n\nNO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente.\n\nOTROS OPCIONALES: buyerPersona, nVariants (default 3), imageModel, imageStyle, styleMix, aspectRatio (default 4:5), generateAdCopy, pauseForAngleReview, features, brandColors, isCombo, creativeDirection.', ImageInput.shape, async (input) => {
     try {
+      const { projectId, ...rest } = input;
       return await submitCreative(api, {
         path: "/v1/creatives/images",
         estimatedSeconds: 60,
-        input,
+        input: {
+          ...rest,
+          ...projectId ? {
+            dropshippingProjectId: projectId
+          } : {}
+        },
         transport
       });
     } catch (e) {
@@ -8766,10 +8830,16 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
   });
   server.tool("generate_landing", 'Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para esos campos, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults): salesAngle, buyerPersona, isCombo, creativeDirection, landingStrategy.', LandingInput.shape, async (input) => {
     try {
+      const { projectId, ...rest } = input;
       return await submitCreative(api, {
         path: "/v1/creatives/landing",
         estimatedSeconds: 60,
-        input,
+        input: {
+          ...rest,
+          ...projectId ? {
+            dropshippingProjectId: projectId
+          } : {}
+        },
         transport
       });
     } catch (e) {
@@ -10451,6 +10521,13 @@ var DropshippingProjectPhase = z51.enum([
   "advertising",
   "complete"
 ]);
+var DropshippingRewardMilestone = z51.enum([
+  "product_selected",
+  "costing_saved",
+  "product_media_ready",
+  "creatives_completed",
+  "campaign_created"
+]);
 var TargetCountry = z51.enum([
   "CO",
   "MX",
@@ -10573,6 +10650,19 @@ var CostingResultSchema = z51.object({
   wasPriceAutoAdjusted: z51.boolean(),
   profitabilityStatus: z51.literal("healthy")
 });
+var RewardProgressSchema = z51.object({
+  campaignKey: z51.literal("dropshipping-launch-v1"),
+  totalCredits: z51.number().int().positive(),
+  earnedCredits: z51.number().int().nonnegative(),
+  milestones: z51.array(z51.object({
+    milestone: DropshippingRewardMilestone,
+    credits: z51.number().int().positive(),
+    available: z51.boolean().optional(),
+    earned: z51.boolean(),
+    grantId: ProjectId.nullable(),
+    grantedAt: z51.string().datetime().nullable()
+  })).length(DropshippingRewardMilestone.options.length)
+});
 var ProjectResponseSchema = z51.object({
   id: ProjectId,
   taskId: ProjectId.nullable(),
@@ -10592,6 +10682,7 @@ var ProjectResponseSchema = z51.object({
   version: z51.number().int().positive(),
   phase: DropshippingProjectPhase,
   nextAction: DropshippingProjectNextAction.nullable(),
+  rewards: RewardProgressSchema,
   createdAt: z51.string().datetime(),
   updatedAt: z51.string().datetime()
 }).passthrough();
@@ -10609,6 +10700,11 @@ function projectText(raw) {
           nextAction: project.nextAction,
           hasReferenceImage: project.hasReferenceImage,
           costingSaved: Boolean(project.costingResult),
+          rewardProgress: {
+            earnedCredits: project.rewards.earnedCredits,
+            totalCredits: project.rewards.totalCredits,
+            milestones: project.rewards.milestones
+          },
           version: project.version,
           message: `Siguiente paso: ${next}. Relee este proyecto despu\xE9s de cada mutaci\xF3n.`
         })

package/dist/stdio.js

@@ -150,7 +150,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "2.1.0";
+var MCP_VERSION = "2.2.0";
 
 // src/tools/tasks.ts
 import { z as z40 } from "zod";
@@ -1421,11 +1421,12 @@ var IngestOptions = z13.object({
   *  shorter than the generated angle count leaves the remaining positions
   *  auto-selected. Empty/omitted → all angles auto-select as before. */
   angleNarratives: z13.array(NarrativeStyle).max(3).optional(),
-  // 720p is the recommended default for every tier (flipped 2026-06-22 — grok provider
-  // unified per-second pricing, so 720p is only a small premium and worth the sharpness).
+  // 480p is the recommended default for every tier (flipped back 2026-07-30 — the
+  // 720p premium is real but small, and users on the entry plan were defaulting
+  // into it while burning half a month of credits on one video).
   // This Zod default is what callers that omit the field (MCP/API) actually get,
-  // so it must agree with resolveSingleCallAwareResolution's unset fallback (720p).
-  videoResolution: VideoResolution.default("720p"),
+  // so it must agree with resolveSingleCallAwareResolution's unset fallback (480p).
+  videoResolution: VideoResolution.default("480p"),
   generateAdCopy: z13.boolean().default(true),
   generateAiMusic: z13.boolean().optional(),
   voiceId: VoiceId.optional(),
@@ -1540,9 +1541,9 @@ var IngestResumePayload = z13.object({
   videoModel: VideoModel.default("veo"),
   videoTier: VideoTier.optional(),
   narrativeStyle: NarrativeStyle.default("review"),
-  // 720p is the recommended default for every tier (flipped 2026-06-22) — keep in sync
-  // with IngestOptions.videoResolution and resolveSingleCallAwareResolution.
-  videoResolution: VideoResolution.default("720p"),
+  // 480p is the recommended default for every tier (flipped back 2026-07-30) — keep in
+  // sync with IngestOptions.videoResolution and resolveSingleCallAwareResolution.
+  videoResolution: VideoResolution.default("480p"),
   pauseForVideoScriptReview: z13.boolean().optional(),
   generateAiMusic: z13.boolean().optional(),
   scriptNotes: z13.string().max(2e3).optional(),
@@ -5001,16 +5002,37 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.15,
     userPriceCents: 0.3
   },
-  // Video QA — independent anatomy arm-scanner (Gemini 3 Flash Preview, one call per
-  // sampled frame, up to ARM_SCAN_MAX_FRAMES per clip). Billed PER FRAME (units: 1 per
-  // call), so this rate is per frame, not per clip. Sized above the 30d prod average
-  // (10.303 entries at $6.81 our => 0.066¢/frame) so the fallback path — used when
-  // OpenRouter omits usage.cost — cannot under-charge. Before this key existed those
-  // fallbacks hit the `No pricing rule found; skipping` branch and went UNBILLED.
+  // Video QA — anatomy. THREE keys, and they do NOT share a unit. Getting this wrong
+  // over-charges by ~42x, which is exactly what a first pass at the 2026-07-30 change did.
+  //
+  // (a) The arm-scan's per-FRAME counting sweep. STILL LIVE on the whole-video concat path
+  //     (`scanClipArms` at apps/api/src/workers/core/video-concat-core.ts), which bills
+  //     units:1 PER SAMPLED FRAME, up to ARM_SCAN_FRAME_CEILING. Rate must stay per-frame.
+  //     Sized above the 30d prod average (10303 rows => 0.132c user/frame).
   "openrouter:video-anatomy-arm-scan": {
     ourCostCents: 0.1,
     userPriceCents: 0.2
   },
+  // (b) The frame JUDGE that replaced the sweep on the `analyzeVideoClipDJ` path: ALL frames
+  //     in ONE multi-image call, so a unit is one call. MEASURED, not estimated —
+  //     usage.cost on a real 16-frame judgement at 768px is $0.0417 => 4.17c our. The table is
+  //     the FALLBACK used when OpenRouter omits usage.cost, so it must sit at or above that.
+  //     Billed PER FRAME (units = frames in the call), like the sweep and for the same reason:
+  //     the cost scales with IMAGES and QA_FRAME_JUDGE_FRAMES is env-overridable, so a per-CALL
+  //     unit would freeze the fallback charge and the credit-gate quote at the cap the rate
+  //     happened to be measured at. Measured $0.0417 over 16 frames => 0.26c/frame; priced at
+  //     0.32c for headroom (n=1 on one clip, and the 1.9k reasoning-token share moves with
+  //     QA_DETECTOR_EFFORT). Re-derive from 30d of BillingEntry once this key has volume.
+  "openrouter:video-qa-anatomy-frame-judge": {
+    ourCostCents: 0.32,
+    userPriceCents: 0.64
+  },
+  // (c) Tracing confirmation of a frames-only finding: 3 stills + a 3s 480p slice, one call,
+  //     no 16-image prompt — materially cheaper than the judgement it verifies.
+  "openrouter:video-qa-anatomy-tracing-confirm": {
+    ourCostCents: 1.5,
+    userPriceCents: 3
+  },
   // Physics confirmation — skeptical second opinion on D+J floating-object flags
   // (Gemini 3 Flash Preview, ~3 frames per flagged moment, 1 call). Aligned with other vision-QA keys.
   "openrouter:video-physics-confirmation": {
@@ -6563,6 +6585,36 @@ var DropshippingProjectStatusSchema = z37.enum([
   "completed",
   "archived"
 ]);
+var DROPSHIPPING_LAUNCH_REWARD_CAMPAIGN = "dropshipping-launch-v1";
+var DropshippingRewardMilestoneSchema = z37.enum([
+  "product_selected",
+  "costing_saved",
+  "product_media_ready",
+  "creatives_completed",
+  "campaign_created"
+]);
+var DROPSHIPPING_LAUNCH_REWARD_CREDITS = {
+  product_selected: 50,
+  costing_saved: 50,
+  product_media_ready: 50,
+  creatives_completed: 150,
+  campaign_created: 200
+};
+var DROPSHIPPING_LAUNCH_REWARD_TOTAL_CREDITS = Object.values(DROPSHIPPING_LAUNCH_REWARD_CREDITS).reduce((sum, credits) => sum + credits, 0);
+var DropshippingProjectRewardMilestoneStateSchema = z37.object({
+  milestone: DropshippingRewardMilestoneSchema,
+  credits: z37.number().int().positive(),
+  available: z37.boolean().optional(),
+  earned: z37.boolean(),
+  grantId: z37.string().uuid().nullable(),
+  grantedAt: z37.string().datetime().nullable()
+});
+var DropshippingProjectRewardProgressSchema = z37.object({
+  campaignKey: z37.literal(DROPSHIPPING_LAUNCH_REWARD_CAMPAIGN),
+  totalCredits: z37.number().int().positive(),
+  earnedCredits: z37.number().int().nonnegative(),
+  milestones: z37.array(DropshippingProjectRewardMilestoneStateSchema).length(DropshippingRewardMilestoneSchema.options.length)
+});
 var DropshippingProjectPhaseSchema = z37.enum([
   "research",
   "costing",
@@ -6720,6 +6772,7 @@ var DropshippingProjectResponseSchema = z37.object({
   version: z37.number().int().positive(),
   phase: DropshippingProjectPhaseSchema,
   nextAction: DropshippingProjectNextActionSchema.nullable(),
+  rewards: DropshippingProjectRewardProgressSchema,
   createdAt: z37.string().datetime(),
   updatedAt: z37.string().datetime()
 });
@@ -6786,7 +6839,7 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "create_product_task",
     confirmation: "credit_consuming",
-    schemaHash: "828ee643bb3a05a63c6e63730459d35ce1621cbd559bbc76a6c5fcec9a45654d"
+    schemaHash: "5b19f7c6dfdc55b0c472df045e24fe73aa134624a141b63342bfbd3bbb0d043b"
   },
   {
     name: "edit_task_draft",
@@ -6811,17 +6864,17 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "generate_image_creatives",
     confirmation: "credit_consuming",
-    schemaHash: "fb6afcf8571887906340fa0b8dd17196d2814e480b734ad5d374e8810958152e"
+    schemaHash: "82b520e8001e9c57ab0a89d9d66ea5dfc92e6306eed302edfe1005cee5025fbf"
   },
   {
     name: "generate_landing",
     confirmation: "credit_consuming",
-    schemaHash: "539922b8fe611c73a7349b1c3f92632fe21f161d7874a0ef2172abfec5834759"
+    schemaHash: "23f0c56dc719235e51d16fd61a9703b64fa6d300356ffbf6b21d703324b0bb18"
   },
   {
     name: "generate_video_creative",
     confirmation: "credit_consuming",
-    schemaHash: "94e90d60ad5d68538c31d880a635c5be69d6d204fd2119139735af83ebf0b94a"
+    schemaHash: "79d3ec9310885b482d62c94a27e9c039833c0619d9332a593fe7d32a60ae1388"
   },
   {
     name: "get_meta_campaign_status",
@@ -8063,7 +8116,7 @@ var CreateProductTaskInput = z40.object({
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo del video: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
   pauseForAngleReview: z40.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. \xDAsalo si quiere decidir 15/30s cuando aparezca un winner. Default false."),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista" para 15s; al pedir durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
-  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez (~el doble de precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   multiAngleVideos: z40.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
   angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar". angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para varios \xE1ngulos.'),
   outputs: z40.array(z40.enum([
@@ -8538,6 +8591,7 @@ var CreativeRefs = {
   isCombo: z41.boolean().optional().describe("Opcional. Si true, el creativo presenta el producto como combo/pack. Default false."),
   competitorScanEnabled: z41.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z41.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer el creativo."),
+  projectId: z41.string().uuid().optional().describe("Opcional. ID de un proyecto guiado de dropshipping activo del usuario. Enlaza esta generaci\xF3n con su progreso y recompensas."),
   creativeDirection: z41.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Aplica SOLO a im\xE1genes y landing. Ej. im\xE1genes: "amarillo, azul y rojo, minimalista"; landing: "elegante, paleta fr\xEDa". Para video usa scriptNotes (ambiente/escenario). M\xE1x 500 caracteres.')
 };
 var VideoInput = z41.object({
@@ -8557,7 +8611,7 @@ var VideoInput = z41.object({
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Los presets funcionan a 15s y 30s. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (una regla visual experimental original), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla).'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista"; para durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
-  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "720p" = m\xE1xima nitidez (RECOMENDADO, default si se omite); "480p" = render m\xE1s econ\xF3mico. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p).'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   features: z41.array(z41.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
   price: CreativeRefs.price,
   offer: CreativeRefs.offer,
@@ -8568,7 +8622,8 @@ var VideoInput = z41.object({
   pauseForVideoScriptReview: z41.boolean().optional().describe("Opcional. Si true, la tarea pausa despu\xE9s de generar el guion y antes de renderizar. \xDAsalo cuando el usuario quiera editar el guion antes de gastar cr\xE9ditos en el video. Tras la pausa: get_video_script para leerlo, approve_video_script para aprobar (con o sin ediciones). Default false."),
   pauseForAngleReview: z41.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. Default false."),
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
-  brandId: CreativeRefs.brandId
+  brandId: CreativeRefs.brandId,
+  projectId: CreativeRefs.projectId
 }).strict();
 var FreeVideoQualityEnum = z41.enum([
   "economical",
@@ -8632,6 +8687,7 @@ var ImageInput = z41.object({
   isCombo: CreativeRefs.isCombo,
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
+  projectId: CreativeRefs.projectId,
   creativeDirection: CreativeRefs.creativeDirection
 });
 var LandingInput = z41.object({
@@ -8649,6 +8705,7 @@ var LandingInput = z41.object({
   isCombo: CreativeRefs.isCombo,
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
+  projectId: CreativeRefs.projectId,
   creativeDirection: CreativeRefs.creativeDirection,
   landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".'),
   landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
@@ -8688,7 +8745,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
     try {
       const resolved = resolveVideoPreset(input.videoPreset);
       const wireTier = resolveWireVideoTier(input.videoTier, input.durationSeconds);
-      const { videoTier: _publicTier, videoResolution: _vr, ...rest } = input;
+      const { videoTier: _publicTier, videoResolution: _vr, projectId, ...rest } = input;
       const wirePayload = {
         ...rest
       };
@@ -8698,6 +8755,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       }
       wirePayload.videoTier = wireTier;
       if (input.videoResolution) wirePayload.videoResolution = input.videoResolution;
+      if (projectId) wirePayload.dropshippingProjectId = projectId;
       return await submitCreative(api, {
         path: "/v1/creatives/videos",
         estimatedSeconds: 300,
@@ -8710,10 +8768,16 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
   });
   server.tool("generate_image_creatives", 'Genera N variantes de imagen creativa (ads est\xE1ticos). Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), productTitle, primaryAngle, language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario:\n- price y offer (se renderizan en la imagen \u2014 nunca los asumas; si dice "t\xFA elige", om\xEDtelos).\n- compareAtPrice si hay descuento (ej. "$129.000" para tachar).\n- creativeArchetype y visualTreatment si quiere un look espec\xEDfico (performance vs premium DTC). Si no le importa, om\xEDtelos.\n\nNO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente.\n\nOTROS OPCIONALES: buyerPersona, nVariants (default 3), imageModel, imageStyle, styleMix, aspectRatio (default 4:5), generateAdCopy, pauseForAngleReview, features, brandColors, isCombo, creativeDirection.', ImageInput.shape, async (input) => {
     try {
+      const { projectId, ...rest } = input;
       return await submitCreative(api, {
         path: "/v1/creatives/images",
         estimatedSeconds: 60,
-        input,
+        input: {
+          ...rest,
+          ...projectId ? {
+            dropshippingProjectId: projectId
+          } : {}
+        },
         transport
       });
     } catch (e) {
@@ -8722,10 +8786,16 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
   });
   server.tool("generate_landing", 'Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para esos campos, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults): salesAngle, buyerPersona, isCombo, creativeDirection, landingStrategy.', LandingInput.shape, async (input) => {
     try {
+      const { projectId, ...rest } = input;
       return await submitCreative(api, {
         path: "/v1/creatives/landing",
         estimatedSeconds: 60,
-        input,
+        input: {
+          ...rest,
+          ...projectId ? {
+            dropshippingProjectId: projectId
+          } : {}
+        },
         transport
       });
     } catch (e) {
@@ -10407,6 +10477,13 @@ var DropshippingProjectPhase = z51.enum([
   "advertising",
   "complete"
 ]);
+var DropshippingRewardMilestone = z51.enum([
+  "product_selected",
+  "costing_saved",
+  "product_media_ready",
+  "creatives_completed",
+  "campaign_created"
+]);
 var TargetCountry = z51.enum([
   "CO",
   "MX",
@@ -10529,6 +10606,19 @@ var CostingResultSchema = z51.object({
   wasPriceAutoAdjusted: z51.boolean(),
   profitabilityStatus: z51.literal("healthy")
 });
+var RewardProgressSchema = z51.object({
+  campaignKey: z51.literal("dropshipping-launch-v1"),
+  totalCredits: z51.number().int().positive(),
+  earnedCredits: z51.number().int().nonnegative(),
+  milestones: z51.array(z51.object({
+    milestone: DropshippingRewardMilestone,
+    credits: z51.number().int().positive(),
+    available: z51.boolean().optional(),
+    earned: z51.boolean(),
+    grantId: ProjectId.nullable(),
+    grantedAt: z51.string().datetime().nullable()
+  })).length(DropshippingRewardMilestone.options.length)
+});
 var ProjectResponseSchema = z51.object({
   id: ProjectId,
   taskId: ProjectId.nullable(),
@@ -10548,6 +10638,7 @@ var ProjectResponseSchema = z51.object({
   version: z51.number().int().positive(),
   phase: DropshippingProjectPhase,
   nextAction: DropshippingProjectNextAction.nullable(),
+  rewards: RewardProgressSchema,
   createdAt: z51.string().datetime(),
   updatedAt: z51.string().datetime()
 }).passthrough();
@@ -10565,6 +10656,11 @@ function projectText(raw) {
           nextAction: project.nextAction,
           hasReferenceImage: project.hasReferenceImage,
           costingSaved: Boolean(project.costingResult),
+          rewardProgress: {
+            earnedCredits: project.rewards.earnedCredits,
+            totalCredits: project.rewards.totalCredits,
+            milestones: project.rewards.milestones
+          },
           version: project.version,
           message: `Siguiente paso: ${next}. Relee este proyecto despu\xE9s de cada mutaci\xF3n.`
         })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — cost products, generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from Claude, ChatGPT, or Gemini.",
@@ -63,8 +63,8 @@
     "tsx": "^4.16.0",
     "typescript": "^7.0.2",
     "vitest": "^2.1.9",
-    "@packages/product-research": "0.1.0",
     "@packages/product-economics": "0.1.0",
+    "@packages/product-research": "0.1.0",
     "@packages/types": "0.1.0"
   },
   "publishConfig": {