filecheck-mcp 0.3.1 → 0.3.3

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.
package/dist/cli.js CHANGED
@@ -725,12 +725,8 @@ function registerJobTools(server, { client }) {
725
725
  jobId: z.string(),
726
726
  taskIds: z.array(z.string()).optional()
727
727
  },
728
- annotations: {
729
- readOnlyHint: false,
730
- destructiveHint: true,
731
- idempotentHint: true,
732
- openWorldHint: true
733
- }
728
+ // Deleting a job never leaves Filecheck: not open world.
729
+ annotations: { ...WRITE, idempotentHint: true }
734
730
  },
735
731
  async (args) => {
736
732
  try {
@@ -1267,7 +1263,7 @@ function registerSetupTools(server, { client }) {
1267
1263
  "list_product_maps",
1268
1264
  {
1269
1265
  title: "List product mappings",
1270
- description: "Every product in the merchant's store that opens a workflow, and which. The storefront Element runs that workflow on the product page.",
1266
+ description: "Every product in the merchant's Shopify store that opens a workflow, and which. The storefront Element runs that workflow on the product page.",
1271
1267
  inputSchema: {},
1272
1268
  annotations: { title: "List product mappings", ...READ }
1273
1269
  },
@@ -1284,7 +1280,7 @@ function registerSetupTools(server, { client }) {
1284
1280
  "find_store_products",
1285
1281
  {
1286
1282
  title: "Find the store's products",
1287
- description: "Reads products from the merchant's connected Shopify store, each with the workflow it is mapped to. Other carts answer cart_not_supported: ask the merchant for the product id instead.",
1283
+ description: "Reads products from the merchant's connected Shopify store, each with the workflow it is mapped to. Other carts answer cart_not_supported: on WooCommerce, PrestaShop and OpenCart the merchant picks a product's workflow in the Filecheck plugin's product settings, so tell them which workflow to pick there instead of mapping it.",
1288
1284
  inputSchema: {
1289
1285
  search: z.string().optional().describe("Words in the product title. Omit for the most recent."),
1290
1286
  cursor: z.string().optional().describe("nextCursor from the previous page.")
@@ -1307,7 +1303,7 @@ function registerSetupTools(server, { client }) {
1307
1303
  "map_product",
1308
1304
  {
1309
1305
  title: "Map a product to a workflow",
1310
- description: "set: the product opens this workflow on its page from now on (customers see it at once: ask first). The workflow must be published. remove: the product stops opening a workflow. Read setup_reference product-map for the record's other fields.",
1306
+ description: "Shopify stores only: on WooCommerce, PrestaShop and OpenCart the merchant picks a product's workflow in the Filecheck plugin's product settings, and a mapping has no effect there, so tell the merchant which workflow to pick instead. set: the product opens this workflow on its page from now on (customers see it at once: ask first). The workflow must be published. remove: the product stops opening a workflow. Read setup_reference product-map for the record's other fields.",
1311
1307
  inputSchema: {
1312
1308
  action: z.enum(["set", "remove"]),
1313
1309
  productId: z.string().describe("The product's id in the store (Shopify: the numeric id)."),
@@ -1538,7 +1534,7 @@ function registerValidatePdf(server, { client, caps }) {
1538
1534
  }
1539
1535
 
1540
1536
  // src/version.ts
1541
- var VERSION = "0.3.1";
1537
+ var VERSION = "0.3.3";
1542
1538
 
1543
1539
  // src/server.ts
1544
1540
  var INSTRUCTIONS = `Filecheck checks print files (PDF, images) for print-readiness, fixes what it can automatically, validates PDF/A / PDF/UA conformance, optimizes, and renders previews.
@@ -1553,11 +1549,11 @@ If a tool returns pending:true, poll get_job with the returned jobId. Never resu
1553
1549
  Typical flow: check_file \u2192 (findings autofixable?) fix_file \u2192 download/save deliverables. Discover profiles and rules with list_catalog.
1554
1550
 
1555
1551
  Setting up a product (which files it accepts, how they are checked and fixed, where finished files go) \u2014 check in with the merchant at each step, in plain words:
1556
- 1. The product: find_store_products (Shopify) or ask for its id; list_product_maps shows what is mapped already.
1552
+ 1. The product: find_store_products and list_product_maps (Shopify). On WooCommerce, PrestaShop and OpenCart the merchant picks a product's workflow in the Filecheck plugin's product settings: there, skip mapping and tell them the workflow's name. A connector is chosen per product in those plugin settings too, never on a workflow.
1557
1553
  2. What exists: list_catalog workflows, rules and profiles. Prefer a built-in (source:'store') one that fits: manage_catalog update on it saves the account's own copy (revert undoes it).
1558
1554
  3. Before writing a record, read its schema with setup_reference. manage_catalog create saves drafts by default; build bottom-up: profile \u2192 rule (its accept entries name the profiles) \u2192 workflow (intake.ruleId, delivery.destinationIds). dryRun: true validates without saving.
1559
1555
  4. Try the draft on a real file: check_file with workflowId (or ruleId). Fix what the result shows.
1560
- 5. Ask before anything customers see: manage_catalog publish (the workflow publishes the drafts it points at), then map_product set, and update_settings.
1556
+ 5. Ask before anything customers see: manage_catalog publish (the workflow publishes the drafts it points at), then map_product set (Shopify), and update_settings.
1561
1557
  Delivery: manage_destination create, then test_destination \u2014 it really writes a sample file into the shop's hotfolder or sends mail, so ask first. Secrets read back as ********.
1562
1558
  Setup errors name the field at fault (param) and list every problem (details): fix those and retry.`;
1563
1559
  function createFilecheckMcp({ client, capabilities }) {