@henrylabs/mcp 0.8.0 → 0.10.0

package/tools/orders/retrieve-status-orders.js

@@ -14,7 +14,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'retrieve_status_orders',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve the status and details of an order given order ID\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/order_retrieve_status_response',\n  $defs: {\n    order_retrieve_status_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            currency: {\n              type: 'string'\n            },\n            grandTotal: {\n              type: 'string'\n            },\n            products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  productName: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  },\n                  productMetadata: {\n                    type: 'object',\n                    additionalProperties: true\n                  }\n                },\n                required: [                  'productName',\n                  'quantity'\n                ]\n              }\n            },\n            shipping: {\n              type: 'string'\n            },\n            status: {\n              type: 'string'\n            },\n            statusMessage: {\n              type: 'string'\n            },\n            subtotal: {\n              type: 'string'\n            },\n            tax: {\n              type: 'string'\n            },\n            userId: {\n              type: 'string'\n            },\n            shippingDetails: {\n              type: 'object',\n              properties: {\n                addressLine1: {\n                  type: 'string'\n                },\n                city: {\n                  type: 'string'\n                },\n                countryCode: {\n                  type: 'string'\n                },\n                email: {\n                  type: 'string'\n                },\n                fullName: {\n                  type: 'string'\n                },\n                phoneNumber: {\n                  type: 'string'\n                },\n                postalCode: {\n                  type: 'string'\n                },\n                stateOrProvince: {\n                  type: 'string'\n                },\n                addressLine2: {\n                  type: 'string'\n                }\n              },\n              required: [                'addressLine1',\n                'city',\n                'countryCode',\n                'email',\n                'fullName',\n                'phoneNumber',\n                'postalCode',\n                'stateOrProvince'\n              ]\n            }\n          },\n          required: [            'id',\n            'currency',\n            'grandTotal',\n            'products',\n            'shipping',\n            'status',\n            'statusMessage',\n            'subtotal',\n            'tax',\n            'userId'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCheck the status and details of an order using its order ID.\n\nReturns:\n- id: Order ID\n- status: Current order status (e.g., \"processing\", \"shipped\", \"delivered\")\n- statusMessage: Detailed status description\n- products: Array with productName, quantity, productMetadata (variants)\n- currency, subtotal, shipping, tax, grandTotal\n- shippingDetails: Full delivery address\n- userId: User who placed order\n- cardLast4: Payment card used (last 4 digits)\n\nUse for:\n- Order tracking\n- Status updates\n- Order history\n- Customer support\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/order_retrieve_status_response',\n  $defs: {\n    order_retrieve_status_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            currency: {\n              type: 'string'\n            },\n            grandTotal: {\n              type: 'string'\n            },\n            products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  productName: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  },\n                  productMetadata: {\n                    type: 'object',\n                    additionalProperties: true\n                  }\n                },\n                required: [                  'productName',\n                  'quantity'\n                ]\n              }\n            },\n            shipping: {\n              type: 'string'\n            },\n            status: {\n              type: 'string'\n            },\n            statusMessage: {\n              type: 'string'\n            },\n            subtotal: {\n              type: 'string'\n            },\n            tax: {\n              type: 'string'\n            },\n            userId: {\n              type: 'string'\n            },\n            shippingDetails: {\n              type: 'object',\n              properties: {\n                addressLine1: {\n                  type: 'string'\n                },\n                city: {\n                  type: 'string'\n                },\n                countryCode: {\n                  type: 'string'\n                },\n                email: {\n                  type: 'string'\n                },\n                fullName: {\n                  type: 'string'\n                },\n                phoneNumber: {\n                  type: 'string'\n                },\n                postalCode: {\n                  type: 'string'\n                },\n                stateOrProvince: {\n                  type: 'string'\n                },\n                addressLine2: {\n                  type: 'string'\n                }\n              },\n              required: [                'addressLine1',\n                'city',\n                'countryCode',\n                'email',\n                'fullName',\n                'phoneNumber',\n                'postalCode',\n                'stateOrProvince'\n              ]\n            }\n          },\n          required: [            'id',\n            'currency',\n            'grandTotal',\n            'products',\n            'shipping',\n            'status',\n            'statusMessage',\n            'subtotal',\n            'tax',\n            'userId'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/orders/retrieve-status-orders.js.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-status-orders.js","sourceRoot":"","sources":["../../src/tools/orders/retrieve-status-orders.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,06GAA06G;IAC56G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"retrieve-status-orders.js","sourceRoot":"","sources":["../../src/tools/orders/retrieve-status-orders.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,s5HAAs5H;IACx5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/orders/retrieve-status-orders.mjs

@@ -11,7 +11,7 @@ export const metadata = {
 };
 export const tool = {
     name: 'retrieve_status_orders',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve the status and details of an order given order ID\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/order_retrieve_status_response',\n  $defs: {\n    order_retrieve_status_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            currency: {\n              type: 'string'\n            },\n            grandTotal: {\n              type: 'string'\n            },\n            products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  productName: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  },\n                  productMetadata: {\n                    type: 'object',\n                    additionalProperties: true\n                  }\n                },\n                required: [                  'productName',\n                  'quantity'\n                ]\n              }\n            },\n            shipping: {\n              type: 'string'\n            },\n            status: {\n              type: 'string'\n            },\n            statusMessage: {\n              type: 'string'\n            },\n            subtotal: {\n              type: 'string'\n            },\n            tax: {\n              type: 'string'\n            },\n            userId: {\n              type: 'string'\n            },\n            shippingDetails: {\n              type: 'object',\n              properties: {\n                addressLine1: {\n                  type: 'string'\n                },\n                city: {\n                  type: 'string'\n                },\n                countryCode: {\n                  type: 'string'\n                },\n                email: {\n                  type: 'string'\n                },\n                fullName: {\n                  type: 'string'\n                },\n                phoneNumber: {\n                  type: 'string'\n                },\n                postalCode: {\n                  type: 'string'\n                },\n                stateOrProvince: {\n                  type: 'string'\n                },\n                addressLine2: {\n                  type: 'string'\n                }\n              },\n              required: [                'addressLine1',\n                'city',\n                'countryCode',\n                'email',\n                'fullName',\n                'phoneNumber',\n                'postalCode',\n                'stateOrProvince'\n              ]\n            }\n          },\n          required: [            'id',\n            'currency',\n            'grandTotal',\n            'products',\n            'shipping',\n            'status',\n            'statusMessage',\n            'subtotal',\n            'tax',\n            'userId'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCheck the status and details of an order using its order ID.\n\nReturns:\n- id: Order ID\n- status: Current order status (e.g., \"processing\", \"shipped\", \"delivered\")\n- statusMessage: Detailed status description\n- products: Array with productName, quantity, productMetadata (variants)\n- currency, subtotal, shipping, tax, grandTotal\n- shippingDetails: Full delivery address\n- userId: User who placed order\n- cardLast4: Payment card used (last 4 digits)\n\nUse for:\n- Order tracking\n- Status updates\n- Order history\n- Customer support\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/order_retrieve_status_response',\n  $defs: {\n    order_retrieve_status_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            currency: {\n              type: 'string'\n            },\n            grandTotal: {\n              type: 'string'\n            },\n            products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  productName: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  },\n                  productMetadata: {\n                    type: 'object',\n                    additionalProperties: true\n                  }\n                },\n                required: [                  'productName',\n                  'quantity'\n                ]\n              }\n            },\n            shipping: {\n              type: 'string'\n            },\n            status: {\n              type: 'string'\n            },\n            statusMessage: {\n              type: 'string'\n            },\n            subtotal: {\n              type: 'string'\n            },\n            tax: {\n              type: 'string'\n            },\n            userId: {\n              type: 'string'\n            },\n            shippingDetails: {\n              type: 'object',\n              properties: {\n                addressLine1: {\n                  type: 'string'\n                },\n                city: {\n                  type: 'string'\n                },\n                countryCode: {\n                  type: 'string'\n                },\n                email: {\n                  type: 'string'\n                },\n                fullName: {\n                  type: 'string'\n                },\n                phoneNumber: {\n                  type: 'string'\n                },\n                postalCode: {\n                  type: 'string'\n                },\n                stateOrProvince: {\n                  type: 'string'\n                },\n                addressLine2: {\n                  type: 'string'\n                }\n              },\n              required: [                'addressLine1',\n                'city',\n                'countryCode',\n                'email',\n                'fullName',\n                'phoneNumber',\n                'postalCode',\n                'stateOrProvince'\n              ]\n            }\n          },\n          required: [            'id',\n            'currency',\n            'grandTotal',\n            'products',\n            'shipping',\n            'status',\n            'statusMessage',\n            'subtotal',\n            'tax',\n            'userId'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/orders/retrieve-status-orders.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-status-orders.mjs","sourceRoot":"","sources":["../../src/tools/orders/retrieve-status-orders.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,06GAA06G;IAC56G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"retrieve-status-orders.mjs","sourceRoot":"","sources":["../../src/tools/orders/retrieve-status-orders.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,s5HAAs5H;IACx5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/products/retrieve-product-details.js

@@ -14,7 +14,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'retrieve_product_details',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve detailed information about a specific product given product ID. Must be called to first get a product link before adding an item to cart\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_retrieve_details_response',\n  $defs: {\n    product_retrieve_details_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            productResults: {\n              type: 'object',\n              properties: {\n                brand: {\n                  type: 'string'\n                },\n                rating: {\n                  type: 'number'\n                },\n                reviews: {\n                  type: 'number'\n                },\n                stores: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      link: {\n                        type: 'string'\n                      },\n                      name: {\n                        type: 'string'\n                      },\n                      price: {\n                        type: 'string'\n                      },\n                      shipping: {\n                        type: 'string'\n                      },\n                      total: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'link',\n                      'name',\n                      'price',\n                      'shipping',\n                      'total'\n                    ]\n                  }\n                },\n                thumbnails: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                title: {\n                  type: 'string'\n                },\n                userReviews: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      rating: {\n                        type: 'number'\n                      },\n                      source: {\n                        type: 'string'\n                      },\n                      text: {\n                        type: 'string'\n                      },\n                      title: {\n                        type: 'string'\n                      },\n                      userName: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'rating',\n                      'source',\n                      'text',\n                      'title',\n                      'userName'\n                    ]\n                  }\n                },\n                variants: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      items: {\n                        type: 'array',\n                        items: {\n                          type: 'object',\n                          properties: {\n                            name: {\n                              type: 'string'\n                            },\n                            available: {\n                              type: 'boolean'\n                            },\n                            selected: {\n                              type: 'boolean'\n                            }\n                          },\n                          required: [                            'name'\n                          ]\n                        }\n                      },\n                      title: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'items',\n                      'title'\n                    ]\n                  }\n                }\n              },\n              required: [                'brand',\n                'rating',\n                'reviews',\n                'stores',\n                'thumbnails',\n                'title',\n                'userReviews',\n                'variants'\n              ]\n            },\n            relatedSearches: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  link: {\n                    type: 'string'\n                  },\n                  query: {\n                    type: 'string'\n                  },\n                  image: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'link',\n                  'query'\n                ]\n              }\n            }\n          },\n          required: [            'productResults',\n            'relatedSearches'\n          ]\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve comprehensive product details using a product ID from search results.\n\nMUST BE CALLED BEFORE adding items to cart - this is the only way to get the productLink required for cart operations.\n\nReturns:\n- Product title, brand, rating, review count\n- Stores array with name, price, shipping, total, and LINK for each retailer\n- Available variants (sizes, colors, etc.) with availability status\n- Thumbnail images (multiple angles)\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_retrieve_details_response',\n  $defs: {\n    product_retrieve_details_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            productResults: {\n              type: 'object',\n              properties: {\n                brand: {\n                  type: 'string'\n                },\n                rating: {\n                  type: 'number'\n                },\n                reviews: {\n                  type: 'number'\n                },\n                stores: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      link: {\n                        type: 'string'\n                      },\n                      name: {\n                        type: 'string'\n                      },\n                      price: {\n                        type: 'string'\n                      },\n                      shipping: {\n                        type: 'string'\n                      },\n                      total: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'link',\n                      'name',\n                      'price',\n                      'shipping',\n                      'total'\n                    ]\n                  }\n                },\n                thumbnails: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                title: {\n                  type: 'string'\n                },\n                userReviews: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      rating: {\n                        type: 'number'\n                      },\n                      source: {\n                        type: 'string'\n                      },\n                      text: {\n                        type: 'string'\n                      },\n                      title: {\n                        type: 'string'\n                      },\n                      userName: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'rating',\n                      'source',\n                      'text',\n                      'title',\n                      'userName'\n                    ]\n                  }\n                },\n                variants: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      items: {\n                        type: 'array',\n                        items: {\n                          type: 'object',\n                          properties: {\n                            name: {\n                              type: 'string'\n                            },\n                            available: {\n                              type: 'boolean'\n                            },\n                            selected: {\n                              type: 'boolean'\n                            }\n                          },\n                          required: [                            'name'\n                          ]\n                        }\n                      },\n                      title: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'items',\n                      'title'\n                    ]\n                  }\n                }\n              },\n              required: [                'brand',\n                'rating',\n                'reviews',\n                'stores',\n                'thumbnails',\n                'title',\n                'userReviews',\n                'variants'\n              ]\n            },\n            relatedSearches: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  link: {\n                    type: 'string'\n                  },\n                  query: {\n                    type: 'string'\n                  },\n                  image: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'link',\n                  'query'\n                ]\n              }\n            }\n          },\n          required: [            'productResults',\n            'relatedSearches'\n          ]\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/products/retrieve-product-details.js.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-product-details.js","sourceRoot":"","sources":["../../src/tools/products/retrieve-product-details.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,02KAA02K;IAC52K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"retrieve-product-details.js","sourceRoot":"","sources":["../../src/tools/products/retrieve-product-details.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,opLAAopL;IACtpL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/products/retrieve-product-details.mjs

@@ -11,7 +11,7 @@ export const metadata = {
 };
 export const tool = {
     name: 'retrieve_product_details',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve detailed information about a specific product given product ID. Must be called to first get a product link before adding an item to cart\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_retrieve_details_response',\n  $defs: {\n    product_retrieve_details_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            productResults: {\n              type: 'object',\n              properties: {\n                brand: {\n                  type: 'string'\n                },\n                rating: {\n                  type: 'number'\n                },\n                reviews: {\n                  type: 'number'\n                },\n                stores: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      link: {\n                        type: 'string'\n                      },\n                      name: {\n                        type: 'string'\n                      },\n                      price: {\n                        type: 'string'\n                      },\n                      shipping: {\n                        type: 'string'\n                      },\n                      total: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'link',\n                      'name',\n                      'price',\n                      'shipping',\n                      'total'\n                    ]\n                  }\n                },\n                thumbnails: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                title: {\n                  type: 'string'\n                },\n                userReviews: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      rating: {\n                        type: 'number'\n                      },\n                      source: {\n                        type: 'string'\n                      },\n                      text: {\n                        type: 'string'\n                      },\n                      title: {\n                        type: 'string'\n                      },\n                      userName: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'rating',\n                      'source',\n                      'text',\n                      'title',\n                      'userName'\n                    ]\n                  }\n                },\n                variants: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      items: {\n                        type: 'array',\n                        items: {\n                          type: 'object',\n                          properties: {\n                            name: {\n                              type: 'string'\n                            },\n                            available: {\n                              type: 'boolean'\n                            },\n                            selected: {\n                              type: 'boolean'\n                            }\n                          },\n                          required: [                            'name'\n                          ]\n                        }\n                      },\n                      title: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'items',\n                      'title'\n                    ]\n                  }\n                }\n              },\n              required: [                'brand',\n                'rating',\n                'reviews',\n                'stores',\n                'thumbnails',\n                'title',\n                'userReviews',\n                'variants'\n              ]\n            },\n            relatedSearches: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  link: {\n                    type: 'string'\n                  },\n                  query: {\n                    type: 'string'\n                  },\n                  image: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'link',\n                  'query'\n                ]\n              }\n            }\n          },\n          required: [            'productResults',\n            'relatedSearches'\n          ]\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve comprehensive product details using a product ID from search results.\n\nMUST BE CALLED BEFORE adding items to cart - this is the only way to get the productLink required for cart operations.\n\nReturns:\n- Product title, brand, rating, review count\n- Stores array with name, price, shipping, total, and LINK for each retailer\n- Available variants (sizes, colors, etc.) with availability status\n- Thumbnail images (multiple angles)\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_retrieve_details_response',\n  $defs: {\n    product_retrieve_details_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            productResults: {\n              type: 'object',\n              properties: {\n                brand: {\n                  type: 'string'\n                },\n                rating: {\n                  type: 'number'\n                },\n                reviews: {\n                  type: 'number'\n                },\n                stores: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      link: {\n                        type: 'string'\n                      },\n                      name: {\n                        type: 'string'\n                      },\n                      price: {\n                        type: 'string'\n                      },\n                      shipping: {\n                        type: 'string'\n                      },\n                      total: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'link',\n                      'name',\n                      'price',\n                      'shipping',\n                      'total'\n                    ]\n                  }\n                },\n                thumbnails: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                title: {\n                  type: 'string'\n                },\n                userReviews: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      rating: {\n                        type: 'number'\n                      },\n                      source: {\n                        type: 'string'\n                      },\n                      text: {\n                        type: 'string'\n                      },\n                      title: {\n                        type: 'string'\n                      },\n                      userName: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'rating',\n                      'source',\n                      'text',\n                      'title',\n                      'userName'\n                    ]\n                  }\n                },\n                variants: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      items: {\n                        type: 'array',\n                        items: {\n                          type: 'object',\n                          properties: {\n                            name: {\n                              type: 'string'\n                            },\n                            available: {\n                              type: 'boolean'\n                            },\n                            selected: {\n                              type: 'boolean'\n                            }\n                          },\n                          required: [                            'name'\n                          ]\n                        }\n                      },\n                      title: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'items',\n                      'title'\n                    ]\n                  }\n                }\n              },\n              required: [                'brand',\n                'rating',\n                'reviews',\n                'stores',\n                'thumbnails',\n                'title',\n                'userReviews',\n                'variants'\n              ]\n            },\n            relatedSearches: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  link: {\n                    type: 'string'\n                  },\n                  query: {\n                    type: 'string'\n                  },\n                  image: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'link',\n                  'query'\n                ]\n              }\n            }\n          },\n          required: [            'productResults',\n            'relatedSearches'\n          ]\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/products/retrieve-product-details.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-product-details.mjs","sourceRoot":"","sources":["../../src/tools/products/retrieve-product-details.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,02KAA02K;IAC52K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"retrieve-product-details.mjs","sourceRoot":"","sources":["../../src/tools/products/retrieve-product-details.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,opLAAopL;IACtpL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,YAAY;aAC1B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/products/search-products.js

@@ -14,7 +14,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'search_products',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nSearch for products using keyword and passing various filters and criteria\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_search_response',\n  $defs: {\n    product_search_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              currency: {\n                type: 'string'\n              },\n              description: {\n                type: 'string'\n              },\n              imageUrl: {\n                type: 'string'\n              },\n              name: {\n                type: 'string'\n              },\n              price: {\n                type: 'number'\n              },\n              source: {\n                type: 'string'\n              },\n              originalPrice: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'currency',\n              'description',\n              'imageUrl',\n              'name',\n              'price',\n              'source'\n            ]\n          }\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nSearch for products using keywords and filters (price range, color, size, gender, manufacturer, region).\n\nReturns basic product information:\n- Product ID (required for next step)\n- Name, price, currency, description\n- Thumbnail image URL\n\nYou MUST call retrieve_product_details() with each product's ID to get:\n- Actual store links for purchasing\n- All available variants\n- Detailed reviews and ratings\n- Price comparisons across stores\n\nRecommended flow:\n1. search_products(query, filters) - Get product IDs\n2. retrieve_product_details(productId) - Get store URLs and variants for each\n3. Present results with images, prices, AND clickable store links\n\nCommon filters: limit (default 10), greaterThanPrice, lowerThanPrice, color, size, gender\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_search_response',\n  $defs: {\n    product_search_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              currency: {\n                type: 'string'\n              },\n              description: {\n                type: 'string'\n              },\n              imageUrl: {\n                type: 'string'\n              },\n              name: {\n                type: 'string'\n              },\n              price: {\n                type: 'number'\n              },\n              source: {\n                type: 'string'\n              },\n              originalPrice: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'currency',\n              'description',\n              'imageUrl',\n              'name',\n              'price',\n              'source'\n            ]\n          }\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/products/search-products.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-products.js","sourceRoot":"","sources":["../../src/tools/products/search-products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,+pDAA+pD;IACjqD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,OAAO;aACrB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6BAA6B;aAC3C;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kBAAkB;aAChC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM;aACpB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"search-products.js","sourceRoot":"","sources":["../../src/tools/products/search-products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,g1EAAg1E;IACl1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,OAAO;aACrB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6BAA6B;aAC3C;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kBAAkB;aAChC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM;aACpB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/products/search-products.mjs

@@ -11,7 +11,7 @@ export const metadata = {
 };
 export const tool = {
     name: 'search_products',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nSearch for products using keyword and passing various filters and criteria\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_search_response',\n  $defs: {\n    product_search_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              currency: {\n                type: 'string'\n              },\n              description: {\n                type: 'string'\n              },\n              imageUrl: {\n                type: 'string'\n              },\n              name: {\n                type: 'string'\n              },\n              price: {\n                type: 'number'\n              },\n              source: {\n                type: 'string'\n              },\n              originalPrice: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'currency',\n              'description',\n              'imageUrl',\n              'name',\n              'price',\n              'source'\n            ]\n          }\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nSearch for products using keywords and filters (price range, color, size, gender, manufacturer, region).\n\nReturns basic product information:\n- Product ID (required for next step)\n- Name, price, currency, description\n- Thumbnail image URL\n\nYou MUST call retrieve_product_details() with each product's ID to get:\n- Actual store links for purchasing\n- All available variants\n- Detailed reviews and ratings\n- Price comparisons across stores\n\nRecommended flow:\n1. search_products(query, filters) - Get product IDs\n2. retrieve_product_details(productId) - Get store URLs and variants for each\n3. Present results with images, prices, AND clickable store links\n\nCommon filters: limit (default 10), greaterThanPrice, lowerThanPrice, color, size, gender\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_search_response',\n  $defs: {\n    product_search_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              currency: {\n                type: 'string'\n              },\n              description: {\n                type: 'string'\n              },\n              imageUrl: {\n                type: 'string'\n              },\n              name: {\n                type: 'string'\n              },\n              price: {\n                type: 'number'\n              },\n              source: {\n                type: 'string'\n              },\n              originalPrice: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'currency',\n              'description',\n              'imageUrl',\n              'name',\n              'price',\n              'source'\n            ]\n          }\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/products/search-products.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"search-products.mjs","sourceRoot":"","sources":["../../src/tools/products/search-products.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,+pDAA+pD;IACjqD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,OAAO;aACrB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6BAA6B;aAC3C;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kBAAkB;aAChC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM;aACpB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"search-products.mjs","sourceRoot":"","sources":["../../src/tools/products/search-products.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,g1EAAg1E;IACl1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,OAAO;aACrB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6BAA6B;aAC3C;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kBAAkB;aAChC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACtB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM;aACpB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/wallet/collect-payment-details.js

@@ -14,7 +14,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'collect_payment_details',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a modal URL for users to save payment cards. Supports both authenticated and guest card collection. Must be called at some point before checkout session is confirmed. After payment details are saved, they can proceed with checkout confirmation.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/wallet_create_card_collection_response',\n  $defs: {\n    wallet_create_card_collection_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            modal_url: {\n              type: 'string'\n            }\n          },\n          required: [            'modal_url'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGenerate a modal URL for securely collecting payment card information via Stripe.\n\nMUST be called in headless checkout flow BEFORE confirm_checkout_session.\n\nParameters:\n- auth: true (default) - requires authentication, false for guest checkout\n\nReturns:\n- modal_url: Stripe-hosted page for card collection\n\nWorkflow:\n1. Call this endpoint\n2. Direct user to modal_url to enter payment details\n3. After user completes payment form, proceed with confirm_checkout_session\n\nThe modal handles:\n- PCI-compliant card collection\n- Card validation\n- Secure tokenization\n- Saving card for future use\n\nFor hosted checkout, payment collection is automatic (use create_cart_checkout instead).\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/wallet_create_card_collection_response',\n  $defs: {\n    wallet_create_card_collection_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            modal_url: {\n              type: 'string'\n            }\n          },\n          required: [            'modal_url'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/wallet/collect-payment-details.js.map

@@ -1 +1 @@
-{"version":3,"file":"collect-payment-details.js","sourceRoot":"","sources":["../../src/tools/wallet/collect-payment-details.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,ymCAAymC;IAC3mC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wEAAwE;aACtF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"collect-payment-details.js","sourceRoot":"","sources":["../../src/tools/wallet/collect-payment-details.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,2iDAA2iD;IAC7iD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wEAAwE;aACtF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/wallet/collect-payment-details.mjs

@@ -11,7 +11,7 @@ export const metadata = {
 };
 export const tool = {
     name: 'collect_payment_details',
-    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a modal URL for users to save payment cards. Supports both authenticated and guest card collection. Must be called at some point before checkout session is confirmed. After payment details are saved, they can proceed with checkout confirmation.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/wallet_create_card_collection_response',\n  $defs: {\n    wallet_create_card_collection_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            modal_url: {\n              type: 'string'\n            }\n          },\n          required: [            'modal_url'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGenerate a modal URL for securely collecting payment card information via Stripe.\n\nMUST be called in headless checkout flow BEFORE confirm_checkout_session.\n\nParameters:\n- auth: true (default) - requires authentication, false for guest checkout\n\nReturns:\n- modal_url: Stripe-hosted page for card collection\n\nWorkflow:\n1. Call this endpoint\n2. Direct user to modal_url to enter payment details\n3. After user completes payment form, proceed with confirm_checkout_session\n\nThe modal handles:\n- PCI-compliant card collection\n- Card validation\n- Secure tokenization\n- Saving card for future use\n\nFor hosted checkout, payment collection is automatic (use create_cart_checkout instead).\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/wallet_create_card_collection_response',\n  $defs: {\n    wallet_create_card_collection_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            modal_url: {\n              type: 'string'\n            }\n          },\n          required: [            'modal_url'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {

package/tools/wallet/collect-payment-details.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect-payment-details.mjs","sourceRoot":"","sources":["../../src/tools/wallet/collect-payment-details.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,ymCAAymC;IAC3mC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wEAAwE;aACtF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"collect-payment-details.mjs","sourceRoot":"","sources":["../../src/tools/wallet/collect-payment-details.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,2iDAA2iD;IAC7iD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wEAAwE;aACtF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAgB,EAAE,IAAyC,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}