@productmaker/mcp 12.2.8 → 12.3.0

package/README.md

@@ -207,7 +207,7 @@ its service-page editor, including its generation progress.
 | `import_orders_file`            | Read the provider's spreadsheet from an ABSOLUTE path on the caller's machine and store its orders. **stdio only** — on the hosted server a path points at OUR disk, so it fails closed. Start with `dryRun: true` and tell the seller what it contains (how many orders, between which dates, which rows could not be read) before writing anything. No column with buyer data is ever read                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `create_operation`              | Create the business of one country. The currency is derived from the country, never asked. Needed before anything else about the month: with no operation there is nothing for `get_finances` to assemble. Someone selling in a single country has one and never hears the word again                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `merge_products`                | Merge two records of the same product into one. The two ids come from `get_product_control` — never invent them. The source DISAPPEARS and its orders move to the target, so confirm by NAME which one stays. It cannot be undone                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| `get_finances`                  | Read-only monthly P&L: gross and delivered sales, freight, merchandise cost, gross profit, ad spend, fixed costs and NET profit **before taxes**, plus each rate against its target. Grouped on purpose: a model that needs six calls to answer "how am I doing?" assembles the picture itself between trips, and that is where it invents. `adSpendKnown: false` means ad spend could not be read and the profit is INCOMPLETE; `adSpendSource: "user"` means she corrected it by hand; `unconfirmedExpenses > 0` is inherited from last month and unreviewed. With one operation the server resolves it; with several it returns `operation_ambiguous` with the list                                                                                                                                                                                                    |
+| `get_finances`                  | Read-only monthly P&L before taxes: sales, costs, advertising, fixed costs and net profit. Unknown actual costs or advertising leave confirmed profit INCOMPLETE. Optional `costEstimate` uses current configured product costs: label it an ESTIMATE, never confirmed historical costs. Null/absent means no estimate. `adSpendSource: "user"` identifies manual correction; `unconfirmedExpenses > 0` flags inherited expenses. The server resolves a single operation or returns `operation_ambiguous`.                                                                                                                                                                                                                                                                                                                                                                |
 | `set_monthly_expense`           | Save one FIXED cost of the month (rent, salaries, accountant). Writing the same label again REPLACES the amount — it does not add a second expense. Without fixed costs written, the month's profit always reads HIGHER than it is. Not for ad spend: that is `set_ad_spend`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `set_ad_spend`                  | Correct by hand what was spent on ads that month. `amount: 0` ASSERTS "I did not advertise"; `null` WITHDRAWS the correction and gives the campaigns back the say. They are not the same                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | `prepare_winning_product_image` | Prepare and show the exact photo of a user-selected winning-product candidate for free; securely stages it before the next photo choice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

package/dist/http.js

@@ -10861,6 +10861,8 @@ var CreativeEngineRecipeSchema = z38.object({
       "silent_sfx"
     ])).min(1),
     imageBackendAvailable: z38.boolean(),
+    /** New journals may overlap independent accepted media under one coordinator. */
+    mediaScheduling: z38.literal("bounded_parallel_v1").optional(),
     /** New server recipes require journaled speech QA; old receipts remain readable. */
     speechAssessment: z38.literal("whisper_v1").optional(),
     /** Frozen server review envelope; legacy readers retain their 48-frame limit. */
@@ -10897,6 +10899,8 @@ var CreativeEngineRecipeSchema = z38.object({
     explicitCastingPolicy: z38.literal("seller_explicit_v1").optional(),
     /** Frozen reviewer-only read model; absent keeps historical full request context. */
     reviewerContextPolicy: z38.literal("selected_commercial_v1").optional(),
+    /** New final reviews explicitly account for selected critical technical findings. */
+    finalReviewContextPolicy: z38.literal("selected_candidate_findings_v1").optional(),
     /** New voice requests after localized lengthening override stale timing only. */
     voiceLengthenDirectionPolicy: z38.literal("slot_duration_v1").optional(),
     /**
@@ -11029,6 +11033,8 @@ var CreativeEngineSceneSchema = z38.object({
     }).strict()
   ]),
   dependsOn: z38.array(id2),
+  /** Subset of dependsOn consumed only as an approved human opening, never a final frame. */
+  openingDependencies: z38.array(id2).optional(),
   visibleSpeaker: z38.enum([
     "human",
     "product",
@@ -11113,7 +11119,10 @@ var reviewUnavailabilityReason = z38.enum([
   "invalid_output",
   "reviewer_declined",
   /** #22: the gate's technical evidence could not be assembled after spend. */
-  "evidence_unavailable"
+  "evidence_unavailable",
+  /** No new purchase is allowed; an owned, verified final can still be delivered. */
+  "cost_budget_exhausted",
+  "post_budget_exhausted"
 ]);
 var CreativeEngineReviewSchema = z38.object({
   id: id2,
@@ -22307,6 +22316,7 @@ var MonthlyExpensesQuerySchema = z97.object({
 
 // ../../packages/types/src/product-alias.ts
 import { z as z98 } from "zod";
+var PRODUCT_ALIAS_LABEL_MAX_LENGTH = 200;
 var PRODUCT_ALIAS_PROVIDERS = [
   "shopify",
   "dropi",
@@ -22323,12 +22333,12 @@ var ProductAliasSchema = z98.object({
    */
   externalId: z98.string().trim().min(1).max(64),
   /** El nombre con el que el archivo lo llamó, para que la persona lo reconozca. */
-  label: z98.string().trim().max(200).optional()
+  label: z98.string().trim().max(PRODUCT_ALIAS_LABEL_MAX_LENGTH).optional()
 }).strict();
 var ResolveUnmatchedProductSchema = z98.object({
   provider: z98.enum(PRODUCT_ALIAS_PROVIDERS),
   externalId: z98.string().trim().min(1).max(64),
-  label: z98.string().trim().min(1).max(200),
+  label: z98.string().trim().min(1).max(PRODUCT_ALIAS_LABEL_MAX_LENGTH),
   operationId: z98.string().uuid(),
   /** Presente ⇒ es el producto al que pertenece. Ausente ⇒ es uno nuevo. */
   productControlId: z98.string().uuid().optional()
@@ -22460,6 +22470,15 @@ var SyncShopifyOrdersSchema = z99.object({
 
 // ../../packages/types/src/product-control.ts
 import { z as z100 } from "zod";
+var MonthlyCostEstimateSchema = z100.object({
+  source: z100.literal("product_costing"),
+  linesEstimated: z100.number().int().positive(),
+  merchandiseCost: z100.number().finite().nonnegative(),
+  freightCost: z100.number().finite().nonnegative(),
+  grossProfit: z100.number().finite(),
+  netProfit: z100.number().finite(),
+  netMarginOnDelivered: z100.number().finite().nullable()
+});
 var ProductControlDailyCountsSchema = z100.object({
   date: z100.string().regex(/^\d{4}-\d{2}-\d{2}$/),
   orders: z100.number().int().nullable(),
@@ -30904,7 +30923,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.2.8";
+var MCP_VERSION = "12.3.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -40999,7 +41018,7 @@ function registerProductControlTools(server, api, { transport = "http" } = {}) {
     }
   });
   server.registerTool("get_finances", {
-    description: getFinancesGuidance.summary + ' Contesta la pregunta que de verdad importa --- \xABeste negocio gana plata?\xBB --- con el mes armado: ventas totales y entregadas, fletes, costo de los productos, utilidad bruta, publicidad, gastos fijos y utilidad NETA. Esa utilidad es ANTES de impuestos y hay que decirlo asi: el contador es un gasto mas, no un calculo nuestro. Trae tambien los porcentajes contra sus metas. Si `deliveredSalesKnown` no es true, faltan importes de ventas entregadas: la utilidad y los m\xE1rgenes no est\xE1n completos. `grossSalesKnown` distinto de true indica ventas totales parciales. Si `costsKnown` viene en `false`, esos pedidos llegaron de una fuente que NO sabe cuanto costaron \u2014la tienda, o la API del proveedor\u2014 y la utilidad BRUTA esta incompleta: no es que el producto salga gratis. Si `adSpendKnown` viene en `false`, la publicidad NO se pudo leer y la utilidad esta INCOMPLETA: dilo antes de que alguien celebre un mes que perdio plata. `adSpendSource: "user"` significa que ella corrigio la cifra a mano, y eso se revisa distinto de una leida. Si `unconfirmedExpenses` es mayor que cero, ese monto viene heredado del mes pasado y ella no lo ha revisado. Es READ-ONLY: nunca pausa ni modifica una campana.',
+    description: getFinancesGuidance.summary + ' Contesta la pregunta que de verdad importa --- \xABeste negocio gana plata?\xBB --- con el mes armado: ventas totales y entregadas, fletes, costo de los productos, utilidad bruta, publicidad, gastos fijos y utilidad NETA. Esa utilidad es ANTES de impuestos y hay que decirlo asi: el contador es un gasto mas, no un calculo nuestro. Trae tambien los porcentajes contra sus metas. Si `deliveredSalesKnown` no es true, faltan importes de ventas entregadas: la utilidad y los m\xE1rgenes no est\xE1n completos. `grossSalesKnown` distinto de true indica ventas totales parciales. Si `costsKnown` viene en `false`, esos pedidos llegaron de una fuente que NO sabe cuanto costaron \u2014la tienda, o la API del proveedor\u2014 y la utilidad BRUTA esta incompleta: no es que el producto salga gratis. Si `adSpendKnown` viene en `false`, la publicidad NO se pudo leer y la utilidad esta INCOMPLETA: dilo antes de que alguien celebre un mes que perdio plata. `adSpendSource: "user"` significa que ella corrigio la cifra a mano, y eso se revisa distinto de una leida. Si `unconfirmedExpenses` es mayor que cero, ese monto viene heredado del mes pasado y ella no lo ha revisado. Es READ-ONLY: nunca pausa ni modifica una campana. Si viene `costEstimate` con `source: "product_costing"`, presenta sus importes como ESTIMACI\xD3N antes de impuestos, usando los costos actuales configurados del producto: no son costos reales confirmados de esos pedidos. Conserva el aviso de `costsKnown: false` y distingue esta estimaci\xF3n de los importes reales del libro. `linesEstimated` indica cu\xE1ntas l\xEDneas usan costos configurados. La API s\xF3lo ofrece esta estimaci\xF3n cuando cubre todos los costos faltantes con perfiles asociados del mismo pa\xEDs y moneda, y conoce ventas entregadas, publicidad y gastos revisados. Si `costEstimate` es null o no existe, no inventes una estimaci\xF3n ni completes importes faltantes.',
     inputSchema: GetFinancesInput.shape,
     annotations: READS_INTERNAL
   }, async (input) => {

package/dist/stdio.js

@@ -10636,6 +10636,8 @@ var CreativeEngineRecipeSchema = z38.object({
       "silent_sfx"
     ])).min(1),
     imageBackendAvailable: z38.boolean(),
+    /** New journals may overlap independent accepted media under one coordinator. */
+    mediaScheduling: z38.literal("bounded_parallel_v1").optional(),
     /** New server recipes require journaled speech QA; old receipts remain readable. */
     speechAssessment: z38.literal("whisper_v1").optional(),
     /** Frozen server review envelope; legacy readers retain their 48-frame limit. */
@@ -10672,6 +10674,8 @@ var CreativeEngineRecipeSchema = z38.object({
     explicitCastingPolicy: z38.literal("seller_explicit_v1").optional(),
     /** Frozen reviewer-only read model; absent keeps historical full request context. */
     reviewerContextPolicy: z38.literal("selected_commercial_v1").optional(),
+    /** New final reviews explicitly account for selected critical technical findings. */
+    finalReviewContextPolicy: z38.literal("selected_candidate_findings_v1").optional(),
     /** New voice requests after localized lengthening override stale timing only. */
     voiceLengthenDirectionPolicy: z38.literal("slot_duration_v1").optional(),
     /**
@@ -10804,6 +10808,8 @@ var CreativeEngineSceneSchema = z38.object({
     }).strict()
   ]),
   dependsOn: z38.array(id2),
+  /** Subset of dependsOn consumed only as an approved human opening, never a final frame. */
+  openingDependencies: z38.array(id2).optional(),
   visibleSpeaker: z38.enum([
     "human",
     "product",
@@ -10888,7 +10894,10 @@ var reviewUnavailabilityReason = z38.enum([
   "invalid_output",
   "reviewer_declined",
   /** #22: the gate's technical evidence could not be assembled after spend. */
-  "evidence_unavailable"
+  "evidence_unavailable",
+  /** No new purchase is allowed; an owned, verified final can still be delivered. */
+  "cost_budget_exhausted",
+  "post_budget_exhausted"
 ]);
 var CreativeEngineReviewSchema = z38.object({
   id: id2,
@@ -22082,6 +22091,7 @@ var MonthlyExpensesQuerySchema = z97.object({
 
 // ../../packages/types/src/product-alias.ts
 import { z as z98 } from "zod";
+var PRODUCT_ALIAS_LABEL_MAX_LENGTH = 200;
 var PRODUCT_ALIAS_PROVIDERS = [
   "shopify",
   "dropi",
@@ -22098,12 +22108,12 @@ var ProductAliasSchema = z98.object({
    */
   externalId: z98.string().trim().min(1).max(64),
   /** El nombre con el que el archivo lo llamó, para que la persona lo reconozca. */
-  label: z98.string().trim().max(200).optional()
+  label: z98.string().trim().max(PRODUCT_ALIAS_LABEL_MAX_LENGTH).optional()
 }).strict();
 var ResolveUnmatchedProductSchema = z98.object({
   provider: z98.enum(PRODUCT_ALIAS_PROVIDERS),
   externalId: z98.string().trim().min(1).max(64),
-  label: z98.string().trim().min(1).max(200),
+  label: z98.string().trim().min(1).max(PRODUCT_ALIAS_LABEL_MAX_LENGTH),
   operationId: z98.string().uuid(),
   /** Presente ⇒ es el producto al que pertenece. Ausente ⇒ es uno nuevo. */
   productControlId: z98.string().uuid().optional()
@@ -22235,6 +22245,15 @@ var SyncShopifyOrdersSchema = z99.object({
 
 // ../../packages/types/src/product-control.ts
 import { z as z100 } from "zod";
+var MonthlyCostEstimateSchema = z100.object({
+  source: z100.literal("product_costing"),
+  linesEstimated: z100.number().int().positive(),
+  merchandiseCost: z100.number().finite().nonnegative(),
+  freightCost: z100.number().finite().nonnegative(),
+  grossProfit: z100.number().finite(),
+  netProfit: z100.number().finite(),
+  netMarginOnDelivered: z100.number().finite().nullable()
+});
 var ProductControlDailyCountsSchema = z100.object({
   date: z100.string().regex(/^\d{4}-\d{2}-\d{2}$/),
   orders: z100.number().int().nullable(),
@@ -29231,7 +29250,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.2.8";
+var MCP_VERSION = "12.3.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -39484,7 +39503,7 @@ function registerProductControlTools(server, api, { transport = "http" } = {}) {
     }
   });
   server.registerTool("get_finances", {
-    description: getFinancesGuidance.summary + ' Contesta la pregunta que de verdad importa --- \xABeste negocio gana plata?\xBB --- con el mes armado: ventas totales y entregadas, fletes, costo de los productos, utilidad bruta, publicidad, gastos fijos y utilidad NETA. Esa utilidad es ANTES de impuestos y hay que decirlo asi: el contador es un gasto mas, no un calculo nuestro. Trae tambien los porcentajes contra sus metas. Si `deliveredSalesKnown` no es true, faltan importes de ventas entregadas: la utilidad y los m\xE1rgenes no est\xE1n completos. `grossSalesKnown` distinto de true indica ventas totales parciales. Si `costsKnown` viene en `false`, esos pedidos llegaron de una fuente que NO sabe cuanto costaron \u2014la tienda, o la API del proveedor\u2014 y la utilidad BRUTA esta incompleta: no es que el producto salga gratis. Si `adSpendKnown` viene en `false`, la publicidad NO se pudo leer y la utilidad esta INCOMPLETA: dilo antes de que alguien celebre un mes que perdio plata. `adSpendSource: "user"` significa que ella corrigio la cifra a mano, y eso se revisa distinto de una leida. Si `unconfirmedExpenses` es mayor que cero, ese monto viene heredado del mes pasado y ella no lo ha revisado. Es READ-ONLY: nunca pausa ni modifica una campana.',
+    description: getFinancesGuidance.summary + ' Contesta la pregunta que de verdad importa --- \xABeste negocio gana plata?\xBB --- con el mes armado: ventas totales y entregadas, fletes, costo de los productos, utilidad bruta, publicidad, gastos fijos y utilidad NETA. Esa utilidad es ANTES de impuestos y hay que decirlo asi: el contador es un gasto mas, no un calculo nuestro. Trae tambien los porcentajes contra sus metas. Si `deliveredSalesKnown` no es true, faltan importes de ventas entregadas: la utilidad y los m\xE1rgenes no est\xE1n completos. `grossSalesKnown` distinto de true indica ventas totales parciales. Si `costsKnown` viene en `false`, esos pedidos llegaron de una fuente que NO sabe cuanto costaron \u2014la tienda, o la API del proveedor\u2014 y la utilidad BRUTA esta incompleta: no es que el producto salga gratis. Si `adSpendKnown` viene en `false`, la publicidad NO se pudo leer y la utilidad esta INCOMPLETA: dilo antes de que alguien celebre un mes que perdio plata. `adSpendSource: "user"` significa que ella corrigio la cifra a mano, y eso se revisa distinto de una leida. Si `unconfirmedExpenses` es mayor que cero, ese monto viene heredado del mes pasado y ella no lo ha revisado. Es READ-ONLY: nunca pausa ni modifica una campana. Si viene `costEstimate` con `source: "product_costing"`, presenta sus importes como ESTIMACI\xD3N antes de impuestos, usando los costos actuales configurados del producto: no son costos reales confirmados de esos pedidos. Conserva el aviso de `costsKnown: false` y distingue esta estimaci\xF3n de los importes reales del libro. `linesEstimated` indica cu\xE1ntas l\xEDneas usan costos configurados. La API s\xF3lo ofrece esta estimaci\xF3n cuando cubre todos los costos faltantes con perfiles asociados del mismo pa\xEDs y moneda, y conoce ventas entregadas, publicidad y gastos revisados. Si `costEstimate` es null o no existe, no inventes una estimaci\xF3n ni completes importes faltantes.',
     inputSchema: GetFinancesInput.shape,
     annotations: READS_INTERNAL
   }, async (input) => {

package/package.json

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