@productmaker/mcp 12.5.0 → 12.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +21 -0
  2. package/dist/http.js +4058 -3188
  3. package/dist/stdio.js +4047 -3177
  4. package/package.json +3 -3
package/README.md CHANGED
@@ -212,6 +212,7 @@ its service-page editor, including its generation progress.
212
212
  | `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 |
213
213
  | `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. |
214
214
  | `get_product_control` | Read-only daily profitability verdicts and measurement status per store product. Incomplete samples or unmeasured delivered sales must remain explicit; never changes campaigns. |
215
+ | `get_product_ads` | Read-only Meta figures for each ad (sales angle) of one product on one day: spend, pixel purchases, cost per purchase, video retention and a keep/turn off/review suggestion against the break-even. Pixel purchases are not store orders; never changes ads. |
215
216
  | `list_importable_products` | Read one page of store products eligible for financial control; preserve `hasNextPage` and already-imported markers. |
216
217
  | `import_product_controls` | Add selected store products to financial control. They remain `no_costing` until their real costs are saved. |
217
218
  | `set_product_costing` | Save seller-provided supplier cost, freight and estimated cancellation/return rates; store price stays canonical and missing costs cannot be invented. |
@@ -225,6 +226,9 @@ its service-page editor, including its generation progress.
225
226
  | `link_product_campaign` | Tie an ad campaign to a product in financial control; its spend then feeds the product's cost-per-sale. The identifiers come from `list_linkable_campaigns` — never invent them. The product is said ONE way: `productControlId`, or `shopDomain` + `shopifyProductId` |
226
227
  | `delete_monthly_expense` | Delete one fixed expense of the month by month + label. To change the amount do NOT delete — `set_monthly_expense` with the new value is the correction |
227
228
  | `remove_product_control` | Remove a product from financial control together with its costs and its linked campaign. The id comes from `get_product_control` — confirm by NAME which product leaves |
229
+ | `get_agent_memory_brief` | Read the Drop Maker agent's memory at the start of a run: latest playbook, product sheets (stage, target CPA, verdict, links), open experiments, open pending items and recent notes. Business numbers are NOT here — read them from financial control |
230
+ | `search_agent_memory` | Search the agent memory by `scope` (notes, experiments, pending, playbook_history) with filters and cursor paging. A filter that does not apply to the scope is rejected |
231
+ | `save_agent_memory` | Single write point for the agent memory; `memory.type` picks product, experiment_open/close, playbook, pending_add/resolve or note. Closing and resolving happen once; a `requestId` UUID makes retries safe. Admin-gated pilot (`agent-memory`) |
228
232
  | `get_actor_voice_capabilities` | Read whether custom voice cloning is enabled for an actor and which countries/presentations the draft may use. Read-only, free — call before `quote_actor_voice` |
229
233
  | `quote_actor_voice` | Quote the paid custom-voice preview for an actor from a voice `draft` (prompt, country, presentation, tone…). Read-only, free |
230
234
  | `generate_actor_voice_preview` | Start the paid contextual voice preview for a quoted draft (Gemini TTS reference → voice clone). Requires the fresh `acceptedQuoteId` and a unique `requestKey` for retry safety. Costs credits |
@@ -361,6 +365,23 @@ a shared `ui.domain`, which breaks hosts with different sandbox-domain rules.
361
365
 
362
366
  ## Version history
363
367
 
368
+ ### 12.5.0 — Drop Maker agent memory
369
+
370
+ Three MCP-only tools give an autonomous selling agent a durable memory inside
371
+ ProductMaker: `get_agent_memory_brief` (read once per run),
372
+ `search_agent_memory` and `save_agent_memory` (one discriminated write:
373
+ product sheet, experiment open/close, playbook revision, pending add/resolve,
374
+ note). Prices, costs, orders and spend are never copied — product sheets link
375
+ to financial control instead. Closed experiments and resolved pending items are
376
+ final (409 with their own code). Behind the `agent-memory` admin feature.
377
+
378
+ The guided project response (`cost_dropshipping_project`,
379
+ `guide_dropshipping_launch`) now carries the saved `costing`: sale price,
380
+ compare-at price, minimum safe price, break-even Ads Manager CPA, estimated
381
+ profit and margin. The `generate_creatives` guidance prices `create_product_task`
382
+ from it and never below the minimum safe price; before, only `costingSaved`
383
+ was returned and an agent priced below that floor.
384
+
364
385
  ### 12.2.0 — Financial-control surfaces for chat
365
386
 
366
387
  Nine financial-control tools open to chat: Dropi status and idempotent order