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/index.js CHANGED
@@ -722,12 +722,8 @@ function registerJobTools(server, { client }) {
722
722
  jobId: z.string(),
723
723
  taskIds: z.array(z.string()).optional()
724
724
  },
725
- annotations: {
726
- readOnlyHint: false,
727
- destructiveHint: true,
728
- idempotentHint: true,
729
- openWorldHint: true
730
- }
725
+ // Deleting a job never leaves Filecheck: not open world.
726
+ annotations: { ...WRITE, idempotentHint: true }
731
727
  },
732
728
  async (args) => {
733
729
  try {
@@ -1264,7 +1260,7 @@ function registerSetupTools(server, { client }) {
1264
1260
  "list_product_maps",
1265
1261
  {
1266
1262
  title: "List product mappings",
1267
- description: "Every product in the merchant's store that opens a workflow, and which. The storefront Element runs that workflow on the product page.",
1263
+ 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.",
1268
1264
  inputSchema: {},
1269
1265
  annotations: { title: "List product mappings", ...READ }
1270
1266
  },
@@ -1281,7 +1277,7 @@ function registerSetupTools(server, { client }) {
1281
1277
  "find_store_products",
1282
1278
  {
1283
1279
  title: "Find the store's products",
1284
- 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.",
1280
+ 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.",
1285
1281
  inputSchema: {
1286
1282
  search: z.string().optional().describe("Words in the product title. Omit for the most recent."),
1287
1283
  cursor: z.string().optional().describe("nextCursor from the previous page.")
@@ -1304,7 +1300,7 @@ function registerSetupTools(server, { client }) {
1304
1300
  "map_product",
1305
1301
  {
1306
1302
  title: "Map a product to a workflow",
1307
- 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.",
1303
+ 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.",
1308
1304
  inputSchema: {
1309
1305
  action: z.enum(["set", "remove"]),
1310
1306
  productId: z.string().describe("The product's id in the store (Shopify: the numeric id)."),
@@ -1535,7 +1531,7 @@ function registerValidatePdf(server, { client, caps }) {
1535
1531
  }
1536
1532
 
1537
1533
  // src/version.ts
1538
- var VERSION = "0.3.1";
1534
+ var VERSION = "0.3.3";
1539
1535
 
1540
1536
  // src/server.ts
1541
1537
  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.
@@ -1550,11 +1546,11 @@ If a tool returns pending:true, poll get_job with the returned jobId. Never resu
1550
1546
  Typical flow: check_file \u2192 (findings autofixable?) fix_file \u2192 download/save deliverables. Discover profiles and rules with list_catalog.
1551
1547
 
1552
1548
  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:
1553
- 1. The product: find_store_products (Shopify) or ask for its id; list_product_maps shows what is mapped already.
1549
+ 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.
1554
1550
  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).
1555
1551
  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.
1556
1552
  4. Try the draft on a real file: check_file with workflowId (or ruleId). Fix what the result shows.
1557
- 5. Ask before anything customers see: manage_catalog publish (the workflow publishes the drafts it points at), then map_product set, and update_settings.
1553
+ 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.
1558
1554
  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 ********.
1559
1555
  Setup errors name the field at fault (param) and list every problem (details): fix those and retry.`;
1560
1556
  function createFilecheckMcp({ client, capabilities }) {