@productmaker/mcp 3.4.1 → 3.4.2

package/dist/http.js

@@ -3692,6 +3692,32 @@ var StatusResponse = z24.object({
   requiresAction: z24.boolean().optional(),
   /** True when the task needs the user's attention rather than passive progress. */
   needsReview: z24.boolean().optional(),
+  /**
+  * THE answer to "does this task still owe the seller a question — now OR later
+  * in this run?". The chat leaves for /tasks/:id only on an explicit `false`,
+  * and /tasks/:id bounces her back on `true`. ONE field drives BOTH directions
+  * on purpose: deciding them on two different facts is what looped
+  * /tasks/:id ↔ wizard before (see apps/web/lib/task-routing.ts).
+  *
+  * STRICTLY WIDER THAN `needsReview`, and the difference is the whole point:
+  *  · `needsReview` answers "is a gate open RIGHT NOW", and it under-reports —
+  *    `buildPendingUserAction` only serves the reference-grouping question when
+  *    it is RENDERABLE, so an unconfirmed target reports `false` while
+  *    `angles.worker` will still pause at the END of the angles stage.
+  *  · this field adds the gates that are GUARANTEED to open: both pause flags,
+  *    plus that same worker prediction, through the one shared helper.
+  *
+  * Absent (undefined) means "an older API that cannot answer" — the client must
+  * treat that as `true` and stay put. Uncertainty resolves to staying: a false
+  * positive costs her a wait, a false negative strands her on a screen that
+  * cannot render the gate (prod bd4d0bb1 / 52dc15a7, both refunded and
+  * undelivered).
+  *
+  * ALWAYS false on a terminal task. `pauseForAngleReview` SURVIVES on completed
+  * tasks, so without that guard a finished landing would report `true` forever
+  * and get bounced into a chat with nothing left to ask.
+  */
+  willAskAgain: z24.boolean().optional(),
   /** True when an open gate exists that somebody can actually ANSWER. A strictly
   *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
   *  below for why conflating the two produced a call to action that led nowhere. */
@@ -3826,6 +3852,9 @@ var CostEstimationType = z25.enum([
   "landing-regenerate",
   "landing-creative",
   "campaign-copy",
+  "brand-extract",
+  "persona-suggest",
+  "chat-parse",
   "service-creative",
   "actor-grid"
 ]);
@@ -3991,11 +4020,14 @@ var LandingCreativeEstimationOptions = z25.object({
   landingStrategy: LandingStrategySchema.optional()
 });
 var CampaignCopyEstimationOptions = z25.object({
-  /** Number of creatives to generate copy for (1-4) */
-  nCreatives: z25.number().int().min(1).max(4),
-  /** Number of image creatives that will use vision analysis (0-4) */
-  nImages: z25.number().int().min(0).max(4).default(0)
-});
+  /** Number of creatives in the one copy-completion request (1-10). */
+  nCreatives: z25.number().int().min(1).max(10),
+  /** Number of image creatives that can each use one vision analysis (0-10). */
+  nImages: z25.number().int().min(0).max(10).default(0)
+});
+var BrandExtractEstimationOptions = z25.object({}).strict();
+var PersonaSuggestEstimationOptions = z25.object({}).strict();
+var ChatParseEstimationOptions = z25.object({}).strict();
 var ServiceCreativeEstimationOptions = z25.object({
   mediaAssetCount: z25.number().int().min(0).max(8).optional(),
   uploadedVideoDurationSeconds: z25.number().min(0).max(240).optional()
@@ -4034,6 +4066,18 @@ var CostEstimationRequest = z25.discriminatedUnion("type", [
     type: z25.literal("campaign-copy"),
     options: CampaignCopyEstimationOptions
   }),
+  z25.object({
+    type: z25.literal("brand-extract"),
+    options: BrandExtractEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("persona-suggest"),
+    options: PersonaSuggestEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("chat-parse"),
+    options: ChatParseEstimationOptions
+  }),
   z25.object({
     type: z25.literal("service-creative"),
     options: ServiceCreativeEstimationOptions
@@ -4533,6 +4577,9 @@ var VideoMixQaJobSchema = z30.object({
 });
 var BrandExtractJobSchema = z30.object({
   brandId: z30.string().uuid(),
+  // Generation is part of the durable paid-spend identity. Default 1 keeps
+  // pre-migration BullMQ payloads parseable; their DB state fails safe.
+  generation: z30.number().int().positive().default(1),
   url: z30.string().url().refine((value) => {
     const protocol = new URL(value).protocol;
     return protocol === "http:" || protocol === "https:";
@@ -11631,7 +11678,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.4.1";
+var MCP_VERSION = "3.4.2";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -11943,6 +11990,7 @@ __name(resolveOne, "resolveOne");
 
 // src/status-poller.ts
 var TERMINAL = /* @__PURE__ */ new Set([
+  "done",
   "complete",
   "error"
 ]);
@@ -12618,6 +12666,7 @@ var McpErrorCode = {
   REVOKED_API_KEY: "REVOKED_API_KEY",
   // Rate limit / quota
   RATE_LIMITED: "RATE_LIMITED",
+  CREDIT_ADMISSION_UNAVAILABLE: "CREDIT_ADMISSION_UNAVAILABLE",
   // Input
   INVALID_INPUT: "INVALID_INPUT",
   INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS",
@@ -12806,6 +12855,7 @@ var CODE_MESSAGES = {
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
+  CREDIT_ADMISSION_UNAVAILABLE: "Credit admission is temporarily unavailable. Do not retry a paid action until ProductMaker can verify the balance.",
   INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
@@ -12900,6 +12950,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.NO_META_AD_ACCOUNTS
 ]);
 var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.DROPSHIPPING_PROJECT_NOT_FOUND,
@@ -12998,6 +13049,7 @@ __name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
 function resolveMessage(code, backendMessage) {
   const mapped = CODE_MESSAGES[code];
   const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (code === McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE && mapped) return mapped;
   if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
     return `${mapped} (Detail: ${backend})`;
   }

package/dist/stdio.js

@@ -264,7 +264,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.4.1";
+var MCP_VERSION = "3.4.2";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -576,6 +576,7 @@ __name(resolveOne, "resolveOne");
 
 // src/status-poller.ts
 var TERMINAL = /* @__PURE__ */ new Set([
+  "done",
   "complete",
   "error"
 ]);
@@ -4313,6 +4314,32 @@ var StatusResponse = z24.object({
   requiresAction: z24.boolean().optional(),
   /** True when the task needs the user's attention rather than passive progress. */
   needsReview: z24.boolean().optional(),
+  /**
+  * THE answer to "does this task still owe the seller a question — now OR later
+  * in this run?". The chat leaves for /tasks/:id only on an explicit `false`,
+  * and /tasks/:id bounces her back on `true`. ONE field drives BOTH directions
+  * on purpose: deciding them on two different facts is what looped
+  * /tasks/:id ↔ wizard before (see apps/web/lib/task-routing.ts).
+  *
+  * STRICTLY WIDER THAN `needsReview`, and the difference is the whole point:
+  *  · `needsReview` answers "is a gate open RIGHT NOW", and it under-reports —
+  *    `buildPendingUserAction` only serves the reference-grouping question when
+  *    it is RENDERABLE, so an unconfirmed target reports `false` while
+  *    `angles.worker` will still pause at the END of the angles stage.
+  *  · this field adds the gates that are GUARANTEED to open: both pause flags,
+  *    plus that same worker prediction, through the one shared helper.
+  *
+  * Absent (undefined) means "an older API that cannot answer" — the client must
+  * treat that as `true` and stay put. Uncertainty resolves to staying: a false
+  * positive costs her a wait, a false negative strands her on a screen that
+  * cannot render the gate (prod bd4d0bb1 / 52dc15a7, both refunded and
+  * undelivered).
+  *
+  * ALWAYS false on a terminal task. `pauseForAngleReview` SURVIVES on completed
+  * tasks, so without that guard a finished landing would report `true` forever
+  * and get bounced into a chat with nothing left to ask.
+  */
+  willAskAgain: z24.boolean().optional(),
   /** True when an open gate exists that somebody can actually ANSWER. A strictly
   *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
   *  below for why conflating the two produced a call to action that led nowhere. */
@@ -4447,6 +4474,9 @@ var CostEstimationType = z25.enum([
   "landing-regenerate",
   "landing-creative",
   "campaign-copy",
+  "brand-extract",
+  "persona-suggest",
+  "chat-parse",
   "service-creative",
   "actor-grid"
 ]);
@@ -4612,11 +4642,14 @@ var LandingCreativeEstimationOptions = z25.object({
   landingStrategy: LandingStrategySchema.optional()
 });
 var CampaignCopyEstimationOptions = z25.object({
-  /** Number of creatives to generate copy for (1-4) */
-  nCreatives: z25.number().int().min(1).max(4),
-  /** Number of image creatives that will use vision analysis (0-4) */
-  nImages: z25.number().int().min(0).max(4).default(0)
-});
+  /** Number of creatives in the one copy-completion request (1-10). */
+  nCreatives: z25.number().int().min(1).max(10),
+  /** Number of image creatives that can each use one vision analysis (0-10). */
+  nImages: z25.number().int().min(0).max(10).default(0)
+});
+var BrandExtractEstimationOptions = z25.object({}).strict();
+var PersonaSuggestEstimationOptions = z25.object({}).strict();
+var ChatParseEstimationOptions = z25.object({}).strict();
 var ServiceCreativeEstimationOptions = z25.object({
   mediaAssetCount: z25.number().int().min(0).max(8).optional(),
   uploadedVideoDurationSeconds: z25.number().min(0).max(240).optional()
@@ -4655,6 +4688,18 @@ var CostEstimationRequest = z25.discriminatedUnion("type", [
     type: z25.literal("campaign-copy"),
     options: CampaignCopyEstimationOptions
   }),
+  z25.object({
+    type: z25.literal("brand-extract"),
+    options: BrandExtractEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("persona-suggest"),
+    options: PersonaSuggestEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("chat-parse"),
+    options: ChatParseEstimationOptions
+  }),
   z25.object({
     type: z25.literal("service-creative"),
     options: ServiceCreativeEstimationOptions
@@ -5154,6 +5199,9 @@ var VideoMixQaJobSchema = z30.object({
 });
 var BrandExtractJobSchema = z30.object({
   brandId: z30.string().uuid(),
+  // Generation is part of the durable paid-spend identity. Default 1 keeps
+  // pre-migration BullMQ payloads parseable; their DB state fails safe.
+  generation: z30.number().int().positive().default(1),
   url: z30.string().url().refine((value) => {
     const protocol = new URL(value).protocol;
     return protocol === "http:" || protocol === "https:";
@@ -11367,6 +11415,7 @@ var McpErrorCode = {
   REVOKED_API_KEY: "REVOKED_API_KEY",
   // Rate limit / quota
   RATE_LIMITED: "RATE_LIMITED",
+  CREDIT_ADMISSION_UNAVAILABLE: "CREDIT_ADMISSION_UNAVAILABLE",
   // Input
   INVALID_INPUT: "INVALID_INPUT",
   INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS",
@@ -11555,6 +11604,7 @@ var CODE_MESSAGES = {
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
+  CREDIT_ADMISSION_UNAVAILABLE: "Credit admission is temporarily unavailable. Do not retry a paid action until ProductMaker can verify the balance.",
   INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
@@ -11649,6 +11699,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.NO_META_AD_ACCOUNTS
 ]);
 var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.DROPSHIPPING_PROJECT_NOT_FOUND,
@@ -11747,6 +11798,7 @@ __name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
 function resolveMessage(code, backendMessage) {
   const mapped = CODE_MESSAGES[code];
   const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (code === McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE && mapped) return mapped;
   if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
     return `${mapped} (Detail: ${backend})`;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "3.4.1",
+  "version": "3.4.2",
   "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.",