@productmaker/mcp 12.1.3 → 12.1.5

package/README.md

@@ -309,6 +309,22 @@ The `base64` field was removed. MCP JSON-RPC transports truncate large tool argu
 
 ## Version history
 
+### 12.1.5 — Service image direction and source recovery
+
+Service images use the saved business identity and service-specific sales direction,
+while Product generation retains its existing authoring and provider recovery.
+Eligible ordinary public-web acquisition failures can recover through server-owned
+Firecrawl custody, with bounded attempts and unchanged customer preparation fees.
+No public provider/key/source setting or confirmation input was added. API rollout,
+compatible Motion agent rollout and Firecrawl configuration remain separate.
+
+### 12.1.4 — Complete product review drafts and authored scenes
+
+Product playback preserves the complete main message, pain points, benefits and
+authored script scenes through review and approval. Draft and narrative changes
+acknowledge the prepared content without additional generation. Public tools and
+request shapes remain compatible.
+
 ### 12.1.3 — Product demo approval playback
 
 - Existing generation and approval tools follow the account's product Demo settings through the canonical API. Public tool schemas and endpoint contracts remain unchanged.

package/dist/http.js

@@ -6682,6 +6682,7 @@ var BillingProvider = z34.enum([
   "openrouter",
   "kie",
   "apify",
+  "firecrawl",
   "elevenlabs",
   "serpapi",
   "meli",
@@ -11092,7 +11093,13 @@ var AD_CREATIVE_MODELS = {
 };
 var KALODATA_USD_CENTS_PER_PROVIDER_CREDIT = 9;
 var KALODATA_PROVIDER_CREDITS_PER_SOURCE_CEILING = 7.5;
+var FIRECRAWL_REFERENCE_CREDIT_COST_CENTS = 0.38;
 var DEFAULT_PRICING = {
+  // Reference estimate only: monthly Hobby $19/5,000 credits. Callers settle actual credits.
+  "firecrawl:service-website-acquisition": {
+    ourCostCents: FIRECRAWL_REFERENCE_CREDIT_COST_CENTS,
+    userPriceCents: 0
+  },
   // IMPORTANT: despite the field name, these values are in *USD cents* (not USD dollars).
   // We store cents (and sometimes fractional cents) everywhere so we can convert to credits:
   // credits = cents * CREDITS_PER_USD_CENT
@@ -23493,6 +23500,16 @@ var ServiceImageIntentSchema = z113.enum([
   "user_brief",
   "delegate_to_ai"
 ]);
+var ServiceImageReferenceRoleSchema = z113.enum([
+  "upload",
+  "logo",
+  "hero",
+  "brand_reference"
+]);
+var ServiceImageReferenceSchema = z113.object({
+  key: z113.string().max(600),
+  role: ServiceImageReferenceRoleSchema
+}).strict();
 var ServiceImageInputSchema = z113.object({
   instruction: z113.string().trim().max(4e3).default(""),
   intent: ServiceImageIntentSchema.default("user_brief")
@@ -23502,6 +23519,48 @@ var ServiceImageInputSchema = z113.object({
     "instruction"
   ]
 });
+var ServiceImageBrandVisualSchema = z113.object({
+  designDirection: z113.string().max(60).optional(),
+  photographyStyle: z113.string().max(60).optional(),
+  buttonStyle: z113.string().max(40).optional(),
+  radiusScale: z113.string().max(40).optional(),
+  fonts: z113.object({
+    display: z113.string().max(120).optional(),
+    body: z113.string().max(120).optional()
+  }).strict().optional(),
+  categoryLayer: z113.string().max(60).optional(),
+  visualAesthetics: z113.array(z113.string().max(80)).max(20).optional(),
+  toneAdjectives: z113.array(z113.string().max(80)).max(20).optional(),
+  coreValues: z113.array(z113.string().max(120)).max(20).optional(),
+  paletteRoles: z113.object({
+    primary: z113.string().max(20).optional(),
+    secondary: z113.string().max(20).optional(),
+    tertiary: z113.string().max(20).optional(),
+    neutral: z113.string().max(20).optional(),
+    accents: z113.array(z113.string().max(20)).max(8).optional()
+  }).strict().optional(),
+  positioning: z113.object({
+    market: z113.string().max(200).optional(),
+    innovation: z113.string().max(200).optional(),
+    trust: z113.string().max(200).optional(),
+    design: z113.string().max(200).optional()
+  }).strict().optional()
+}).strict();
+var ServiceImagePersonaSchema = z113.object({
+  name: z113.string().max(200),
+  demographics: z113.string().max(2e3).optional(),
+  painPoints: z113.array(z113.string().max(2e3)).max(10).optional(),
+  motivations: z113.string().max(2e3).optional(),
+  objections: z113.string().max(2e3).optional(),
+  gender: z113.string().max(60).optional()
+}).strict();
+var ServiceImageBusinessSchema = z113.object({
+  painPoints: z113.string().max(2e3).optional(),
+  benefits: z113.string().max(2e3).optional(),
+  whatsappNumber: z113.string().max(40).optional(),
+  whatsappMessage: z113.string().max(500).optional(),
+  facts: ServicePageFactsSchema.optional()
+}).strict();
 var ServiceImageContextSchema = z113.object({
   kind: z113.literal("service_image"),
   version: z113.literal(1),
@@ -23511,7 +23570,11 @@ var ServiceImageContextSchema = z113.object({
   description: z113.string().max(2e4),
   brandCard: z113.string().max(2e4),
   palette: z113.array(z113.string()).max(20),
-  referenceKeys: z113.array(z113.string()).max(10)
+  referenceKeys: z113.array(z113.string()).max(10),
+  references: z113.array(ServiceImageReferenceSchema).max(10).optional(),
+  brandVisual: ServiceImageBrandVisualSchema.optional(),
+  persona: ServiceImagePersonaSchema.optional(),
+  business: ServiceImageBusinessSchema.optional()
 }).strict();
 
 // ../../packages/types/src/brand-creation.ts
@@ -23618,12 +23681,15 @@ var WEBSITE_CAPTURE_TIMING = {
   clientWaitMs: captureQueueMs + captureLeaseMs,
   readyMs: 30 * 6e4,
   bridgeRequestMs: 3e4,
-  uploadMs: 9e4
+  uploadMs: 9e4,
+  fallbackRequestMs: 6e4,
+  fallbackMinimumRemainingMs: 9e4
 };
 var WEBSITE_CAPTURE_MAX_RESEARCH_BYTES = 1024 * 1024;
 var WEBSITE_CAPTURE_MAX_FILES = 100;
 var WEBSITE_CAPTURE_MAX_FILE_BYTES = 8 * 1024 * 1024;
 var WEBSITE_CAPTURE_MAX_BUNDLE_BYTES = 30 * 1024 * 1024;
+var WEBSITE_CAPTURE_MAX_SOURCE_HTML_BYTES = 2 * 1024 * 1024;
 var WebsiteCaptureCauseSchema = z116.enum([
   "site_blocked",
   "site_unreachable",
@@ -23670,7 +23736,9 @@ var WebsiteCaptureJobSchema = WebsiteCaptureRequestSchema.extend({
   attempt: z116.number().int().positive(),
   leaseUntil: z116.string().datetime(),
   /** Public profile document prepared by the API; never contains a provider credential. */
-  socialProfileHtml: z116.string().max(2e5).optional()
+  socialProfileHtml: z116.string().max(2e5).optional(),
+  /** Present only after explicit capability negotiation; legacy agents retain the old wire. */
+  websiteFallback: z116.literal("v1").optional()
 });
 var WebsiteCaptureClaimResponseSchema = z116.object({
   capture: WebsiteCaptureJobSchema.nullable()
@@ -23679,6 +23747,34 @@ var attempt = {
   attempt: z116.number().int().positive()
 };
 var digest2 = z116.string().regex(/^[a-f0-9]{64}$/);
+var WebsiteCaptureFallbackReasonSchema = z116.enum([
+  "http_403",
+  "http_408",
+  "http_429",
+  "http_5xx",
+  "navigation_timeout",
+  "render_timeout",
+  "anti_bot"
+]);
+var WebsiteCaptureFallbackRequestSchema = z116.object({
+  ...attempt,
+  leaseUntil: z116.string().datetime(),
+  deadlineAt: z116.string().datetime(),
+  reason: WebsiteCaptureFallbackReasonSchema,
+  browserClosed: z116.literal(true)
+}).strict();
+var sourceArtifactUrl = z116.string().url().max(8192).refine((value) => {
+  const url = new URL(value);
+  return url.protocol === "https:" && !url.username && !url.password;
+});
+var WebsiteCaptureExternalSourceSchema = z116.object({
+  kind: z116.literal("firecrawl"),
+  finalUrl: z116.string().url().max(2048).refine((value) => normalizeWebsiteCaptureUrl(value) !== null),
+  htmlUrl: sourceArtifactUrl,
+  htmlSha256: digest2,
+  screenshotUrl: sourceArtifactUrl,
+  screenshotSha256: digest2
+}).strict();
 var WebsiteCaptureUploadRequestSchema = z116.object({
   ...attempt,
   contentLength: z116.number().int().positive().max(WEBSITE_CAPTURE_MAX_BUNDLE_BYTES),
@@ -23802,6 +23898,10 @@ var image = z117.object({
   rawResponse: z117.unknown()
 });
 var ProductDemoSnapshotSchema = z117.object({
+  /** Optional only for packs frozen before seller review drafts were captured. */
+  customAngleOverride: nullableText.optional(),
+  painPoints: nullableText.optional(),
+  benefits: nullableText.optional(),
   product: z117.object({
     title: text3,
     price: nullableText,
@@ -26044,7 +26144,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.1.3";
+var MCP_VERSION = "12.1.5";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";

package/dist/stdio.js

@@ -6704,6 +6704,7 @@ var BillingProvider = z34.enum([
   "openrouter",
   "kie",
   "apify",
+  "firecrawl",
   "elevenlabs",
   "serpapi",
   "meli",
@@ -10867,7 +10868,13 @@ var AD_CREATIVE_MODELS = {
 };
 var KALODATA_USD_CENTS_PER_PROVIDER_CREDIT = 9;
 var KALODATA_PROVIDER_CREDITS_PER_SOURCE_CEILING = 7.5;
+var FIRECRAWL_REFERENCE_CREDIT_COST_CENTS = 0.38;
 var DEFAULT_PRICING = {
+  // Reference estimate only: monthly Hobby $19/5,000 credits. Callers settle actual credits.
+  "firecrawl:service-website-acquisition": {
+    ourCostCents: FIRECRAWL_REFERENCE_CREDIT_COST_CENTS,
+    userPriceCents: 0
+  },
   // IMPORTANT: despite the field name, these values are in *USD cents* (not USD dollars).
   // We store cents (and sometimes fractional cents) everywhere so we can convert to credits:
   // credits = cents * CREDITS_PER_USD_CENT
@@ -23261,6 +23268,16 @@ var ServiceImageIntentSchema = z113.enum([
   "user_brief",
   "delegate_to_ai"
 ]);
+var ServiceImageReferenceRoleSchema = z113.enum([
+  "upload",
+  "logo",
+  "hero",
+  "brand_reference"
+]);
+var ServiceImageReferenceSchema = z113.object({
+  key: z113.string().max(600),
+  role: ServiceImageReferenceRoleSchema
+}).strict();
 var ServiceImageInputSchema = z113.object({
   instruction: z113.string().trim().max(4e3).default(""),
   intent: ServiceImageIntentSchema.default("user_brief")
@@ -23270,6 +23287,48 @@ var ServiceImageInputSchema = z113.object({
     "instruction"
   ]
 });
+var ServiceImageBrandVisualSchema = z113.object({
+  designDirection: z113.string().max(60).optional(),
+  photographyStyle: z113.string().max(60).optional(),
+  buttonStyle: z113.string().max(40).optional(),
+  radiusScale: z113.string().max(40).optional(),
+  fonts: z113.object({
+    display: z113.string().max(120).optional(),
+    body: z113.string().max(120).optional()
+  }).strict().optional(),
+  categoryLayer: z113.string().max(60).optional(),
+  visualAesthetics: z113.array(z113.string().max(80)).max(20).optional(),
+  toneAdjectives: z113.array(z113.string().max(80)).max(20).optional(),
+  coreValues: z113.array(z113.string().max(120)).max(20).optional(),
+  paletteRoles: z113.object({
+    primary: z113.string().max(20).optional(),
+    secondary: z113.string().max(20).optional(),
+    tertiary: z113.string().max(20).optional(),
+    neutral: z113.string().max(20).optional(),
+    accents: z113.array(z113.string().max(20)).max(8).optional()
+  }).strict().optional(),
+  positioning: z113.object({
+    market: z113.string().max(200).optional(),
+    innovation: z113.string().max(200).optional(),
+    trust: z113.string().max(200).optional(),
+    design: z113.string().max(200).optional()
+  }).strict().optional()
+}).strict();
+var ServiceImagePersonaSchema = z113.object({
+  name: z113.string().max(200),
+  demographics: z113.string().max(2e3).optional(),
+  painPoints: z113.array(z113.string().max(2e3)).max(10).optional(),
+  motivations: z113.string().max(2e3).optional(),
+  objections: z113.string().max(2e3).optional(),
+  gender: z113.string().max(60).optional()
+}).strict();
+var ServiceImageBusinessSchema = z113.object({
+  painPoints: z113.string().max(2e3).optional(),
+  benefits: z113.string().max(2e3).optional(),
+  whatsappNumber: z113.string().max(40).optional(),
+  whatsappMessage: z113.string().max(500).optional(),
+  facts: ServicePageFactsSchema.optional()
+}).strict();
 var ServiceImageContextSchema = z113.object({
   kind: z113.literal("service_image"),
   version: z113.literal(1),
@@ -23279,7 +23338,11 @@ var ServiceImageContextSchema = z113.object({
   description: z113.string().max(2e4),
   brandCard: z113.string().max(2e4),
   palette: z113.array(z113.string()).max(20),
-  referenceKeys: z113.array(z113.string()).max(10)
+  referenceKeys: z113.array(z113.string()).max(10),
+  references: z113.array(ServiceImageReferenceSchema).max(10).optional(),
+  brandVisual: ServiceImageBrandVisualSchema.optional(),
+  persona: ServiceImagePersonaSchema.optional(),
+  business: ServiceImageBusinessSchema.optional()
 }).strict();
 
 // ../../packages/types/src/brand-creation.ts
@@ -23386,12 +23449,15 @@ var WEBSITE_CAPTURE_TIMING = {
   clientWaitMs: captureQueueMs + captureLeaseMs,
   readyMs: 30 * 6e4,
   bridgeRequestMs: 3e4,
-  uploadMs: 9e4
+  uploadMs: 9e4,
+  fallbackRequestMs: 6e4,
+  fallbackMinimumRemainingMs: 9e4
 };
 var WEBSITE_CAPTURE_MAX_RESEARCH_BYTES = 1024 * 1024;
 var WEBSITE_CAPTURE_MAX_FILES = 100;
 var WEBSITE_CAPTURE_MAX_FILE_BYTES = 8 * 1024 * 1024;
 var WEBSITE_CAPTURE_MAX_BUNDLE_BYTES = 30 * 1024 * 1024;
+var WEBSITE_CAPTURE_MAX_SOURCE_HTML_BYTES = 2 * 1024 * 1024;
 var WebsiteCaptureCauseSchema = z116.enum([
   "site_blocked",
   "site_unreachable",
@@ -23438,7 +23504,9 @@ var WebsiteCaptureJobSchema = WebsiteCaptureRequestSchema.extend({
   attempt: z116.number().int().positive(),
   leaseUntil: z116.string().datetime(),
   /** Public profile document prepared by the API; never contains a provider credential. */
-  socialProfileHtml: z116.string().max(2e5).optional()
+  socialProfileHtml: z116.string().max(2e5).optional(),
+  /** Present only after explicit capability negotiation; legacy agents retain the old wire. */
+  websiteFallback: z116.literal("v1").optional()
 });
 var WebsiteCaptureClaimResponseSchema = z116.object({
   capture: WebsiteCaptureJobSchema.nullable()
@@ -23447,6 +23515,34 @@ var attempt = {
   attempt: z116.number().int().positive()
 };
 var digest2 = z116.string().regex(/^[a-f0-9]{64}$/);
+var WebsiteCaptureFallbackReasonSchema = z116.enum([
+  "http_403",
+  "http_408",
+  "http_429",
+  "http_5xx",
+  "navigation_timeout",
+  "render_timeout",
+  "anti_bot"
+]);
+var WebsiteCaptureFallbackRequestSchema = z116.object({
+  ...attempt,
+  leaseUntil: z116.string().datetime(),
+  deadlineAt: z116.string().datetime(),
+  reason: WebsiteCaptureFallbackReasonSchema,
+  browserClosed: z116.literal(true)
+}).strict();
+var sourceArtifactUrl = z116.string().url().max(8192).refine((value) => {
+  const url = new URL(value);
+  return url.protocol === "https:" && !url.username && !url.password;
+});
+var WebsiteCaptureExternalSourceSchema = z116.object({
+  kind: z116.literal("firecrawl"),
+  finalUrl: z116.string().url().max(2048).refine((value) => normalizeWebsiteCaptureUrl(value) !== null),
+  htmlUrl: sourceArtifactUrl,
+  htmlSha256: digest2,
+  screenshotUrl: sourceArtifactUrl,
+  screenshotSha256: digest2
+}).strict();
 var WebsiteCaptureUploadRequestSchema = z116.object({
   ...attempt,
   contentLength: z116.number().int().positive().max(WEBSITE_CAPTURE_MAX_BUNDLE_BYTES),
@@ -23570,6 +23666,10 @@ var image = z117.object({
   rawResponse: z117.unknown()
 });
 var ProductDemoSnapshotSchema = z117.object({
+  /** Optional only for packs frozen before seller review drafts were captured. */
+  customAngleOverride: nullableText.optional(),
+  painPoints: nullableText.optional(),
+  benefits: nullableText.optional(),
   product: z117.object({
     title: text3,
     price: nullableText,
@@ -24371,7 +24471,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.1.3";
+var MCP_VERSION = "12.1.5";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "12.1.3",
+  "version": "12.1.5",
   "type": "module",
   "private": false,
   "description": "ProductMaker MCP server — cost products, generate landing pages, UGC videos, and ad creatives, and publish to Shopify, Meta Ads, and TikTok Ads.",
@@ -67,8 +67,8 @@
     "typescript": "^7.0.2",
     "vitest": "5.0.3",
     "@packages/product-economics": "0.1.0",
-    "@packages/types": "0.1.0",
-    "@packages/utils": "0.1.0"
+    "@packages/utils": "0.1.0",
+    "@packages/types": "0.1.0"
   },
   "publishConfig": {
     "access": "public"