plytix-mcp-server 0.0.0-stage → 0.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.
- package/LICENSE +21 -0
- package/README.md +410 -2
- package/dist/BUILD_INFO.json +8 -0
- package/dist/batch/bulk.d.ts +100 -0
- package/dist/batch/bulk.d.ts.map +1 -0
- package/dist/batch/bulk.js +401 -0
- package/dist/batch/bulk.js.map +1 -0
- package/dist/batch/export-file.d.ts +6 -0
- package/dist/batch/export-file.d.ts.map +1 -0
- package/dist/batch/export-file.js +187 -0
- package/dist/batch/export-file.js.map +1 -0
- package/dist/batch/export.d.ts +53 -0
- package/dist/batch/export.d.ts.map +1 -0
- package/dist/batch/export.js +673 -0
- package/dist/batch/export.js.map +1 -0
- package/dist/batch/helpers.d.ts +76 -0
- package/dist/batch/helpers.d.ts.map +1 -0
- package/dist/batch/helpers.js +318 -0
- package/dist/batch/helpers.js.map +1 -0
- package/dist/batch/manifest-submit.d.ts +21 -0
- package/dist/batch/manifest-submit.d.ts.map +1 -0
- package/dist/batch/manifest-submit.js +49 -0
- package/dist/batch/manifest-submit.js.map +1 -0
- package/dist/batch/manifest.d.ts +20 -0
- package/dist/batch/manifest.d.ts.map +1 -0
- package/dist/batch/manifest.js +96 -0
- package/dist/batch/manifest.js.map +1 -0
- package/dist/batch/runner.d.ts +39 -0
- package/dist/batch/runner.d.ts.map +1 -0
- package/dist/batch/runner.js +374 -0
- package/dist/batch/runner.js.map +1 -0
- package/dist/catalog-admin.d.ts +29 -0
- package/dist/catalog-admin.d.ts.map +1 -0
- package/dist/catalog-admin.js +215 -0
- package/dist/catalog-admin.js.map +1 -0
- package/dist/catalog-detail.d.ts +28 -0
- package/dist/catalog-detail.d.ts.map +1 -0
- package/dist/catalog-detail.js +59 -0
- package/dist/catalog-detail.js.map +1 -0
- package/dist/catalog-reads.d.ts +29 -0
- package/dist/catalog-reads.d.ts.map +1 -0
- package/dist/catalog-reads.js +99 -0
- package/dist/catalog-reads.js.map +1 -0
- package/dist/catalog-tools.d.ts +48 -0
- package/dist/catalog-tools.d.ts.map +1 -0
- package/dist/catalog-tools.js +31 -0
- package/dist/catalog-tools.js.map +1 -0
- package/dist/client.d.ts +252 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +842 -0
- package/dist/client.js.map +1 -0
- package/dist/extensions/index.d.ts +13 -0
- package/dist/extensions/index.d.ts.map +1 -0
- package/dist/extensions/index.js +14 -0
- package/dist/extensions/index.js.map +1 -0
- package/dist/extensions/supplyline-submit.d.ts +17 -0
- package/dist/extensions/supplyline-submit.d.ts.map +1 -0
- package/dist/extensions/supplyline-submit.js +162 -0
- package/dist/extensions/supplyline-submit.js.map +1 -0
- package/dist/family-levels.d.ts +44 -0
- package/dist/family-levels.d.ts.map +1 -0
- package/dist/family-levels.js +66 -0
- package/dist/family-levels.js.map +1 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +71 -0
- package/dist/index.js.map +1 -0
- package/dist/lookup/identifier.d.ts +38 -0
- package/dist/lookup/identifier.d.ts.map +1 -0
- package/dist/lookup/identifier.js +77 -0
- package/dist/lookup/identifier.js.map +1 -0
- package/dist/lookup/index.d.ts +3 -0
- package/dist/lookup/index.d.ts.map +1 -0
- package/dist/lookup/index.js +3 -0
- package/dist/lookup/index.js.map +1 -0
- package/dist/lookup/lookup.d.ts +85 -0
- package/dist/lookup/lookup.d.ts.map +1 -0
- package/dist/lookup/lookup.js +465 -0
- package/dist/lookup/lookup.js.map +1 -0
- package/dist/product-create.d.ts +21 -0
- package/dist/product-create.d.ts.map +1 -0
- package/dist/product-create.js +65 -0
- package/dist/product-create.js.map +1 -0
- package/dist/protocol.d.ts +177 -0
- package/dist/protocol.d.ts.map +1 -0
- package/dist/protocol.js +329 -0
- package/dist/protocol.js.map +1 -0
- package/dist/rate-limit.d.ts +128 -0
- package/dist/rate-limit.d.ts.map +1 -0
- package/dist/rate-limit.js +378 -0
- package/dist/rate-limit.js.map +1 -0
- package/dist/safety.d.ts +114 -0
- package/dist/safety.d.ts.map +1 -0
- package/dist/safety.js +230 -0
- package/dist/safety.js.map +1 -0
- package/dist/schema-write-ops.d.ts +89 -0
- package/dist/schema-write-ops.d.ts.map +1 -0
- package/dist/schema-write-ops.js +409 -0
- package/dist/schema-write-ops.js.map +1 -0
- package/dist/schema-writes.d.ts +164 -0
- package/dist/schema-writes.d.ts.map +1 -0
- package/dist/schema-writes.js +416 -0
- package/dist/schema-writes.js.map +1 -0
- package/dist/search-projection.d.ts +14 -0
- package/dist/search-projection.d.ts.map +1 -0
- package/dist/search-projection.js +18 -0
- package/dist/search-projection.js.map +1 -0
- package/dist/tool-annotations.d.ts +10 -0
- package/dist/tool-annotations.d.ts.map +1 -0
- package/dist/tool-annotations.js +21 -0
- package/dist/tool-annotations.js.map +1 -0
- package/dist/tools/assets.d.ts +9 -0
- package/dist/tools/assets.d.ts.map +1 -0
- package/dist/tools/assets.js +269 -0
- package/dist/tools/assets.js.map +1 -0
- package/dist/tools/attributes.d.ts +10 -0
- package/dist/tools/attributes.d.ts.map +1 -0
- package/dist/tools/attributes.js +379 -0
- package/dist/tools/attributes.js.map +1 -0
- package/dist/tools/categories.d.ts +10 -0
- package/dist/tools/categories.d.ts.map +1 -0
- package/dist/tools/categories.js +202 -0
- package/dist/tools/categories.js.map +1 -0
- package/dist/tools/families.d.ts +10 -0
- package/dist/tools/families.d.ts.map +1 -0
- package/dist/tools/families.js +295 -0
- package/dist/tools/families.js.map +1 -0
- package/dist/tools/identifier.d.ts +9 -0
- package/dist/tools/identifier.d.ts.map +1 -0
- package/dist/tools/identifier.js +139 -0
- package/dist/tools/identifier.js.map +1 -0
- package/dist/tools/product-attributes.d.ts +9 -0
- package/dist/tools/product-attributes.d.ts.map +1 -0
- package/dist/tools/product-attributes.js +179 -0
- package/dist/tools/product-attributes.js.map +1 -0
- package/dist/tools/products.d.ts +4 -0
- package/dist/tools/products.d.ts.map +1 -0
- package/dist/tools/products.js +780 -0
- package/dist/tools/products.js.map +1 -0
- package/dist/tools/register.d.ts +34 -0
- package/dist/tools/register.d.ts.map +1 -0
- package/dist/tools/register.js +26 -0
- package/dist/tools/register.js.map +1 -0
- package/dist/tools/relationships.d.ts +9 -0
- package/dist/tools/relationships.d.ts.map +1 -0
- package/dist/tools/relationships.js +225 -0
- package/dist/tools/relationships.js.map +1 -0
- package/dist/tools/variants.d.ts +9 -0
- package/dist/tools/variants.d.ts.map +1 -0
- package/dist/tools/variants.js +206 -0
- package/dist/tools/variants.js.map +1 -0
- package/dist/types.d.ts +458 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +46 -0
- package/dist/types.js.map +1 -0
- package/dist/utils/attribute-labels.d.ts +5 -0
- package/dist/utils/attribute-labels.d.ts.map +1 -0
- package/dist/utils/attribute-labels.js +8 -0
- package/dist/utils/attribute-labels.js.map +1 -0
- package/dist/utils/product-get-projection.d.ts +21 -0
- package/dist/utils/product-get-projection.d.ts.map +1 -0
- package/dist/utils/product-get-projection.js +59 -0
- package/dist/utils/product-get-projection.js.map +1 -0
- package/dist/utils/product-search-filters.d.ts +10 -0
- package/dist/utils/product-search-filters.d.ts.map +1 -0
- package/dist/utils/product-search-filters.js +48 -0
- package/dist/utils/product-search-filters.js.map +1 -0
- package/dist/utils/validate-attribute.d.ts +10 -0
- package/dist/utils/validate-attribute.d.ts.map +1 -0
- package/dist/utils/validate-attribute.js +47 -0
- package/dist/utils/validate-attribute.js.map +1 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +9 -0
- package/dist/version.js.map +1 -0
- package/package.json +67 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Eric Pittman
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,411 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Plytix MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A **lightweight, stateless Model Context Protocol (MCP) server** that provides AI assistants with live access to Plytix PIM (Product Information Management) data. This server enables AI tools like Claude Desktop, Claude mobile app, and other MCP clients to search, look up, and retrieve product information directly from the Plytix API.
|
|
4
|
+
|
|
5
|
+
> **Note:** This is a stateless, live API tool for read and write operations. For sync, caching, or ETL workflows, pair it with a separate persistence layer of your choosing.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- **51 MCP tools via stdio and 46 via the remote worker**
|
|
10
|
+
- **Smart product lookup** with automatic identifier detection (SKU, MPN, GTIN, label)
|
|
11
|
+
- **Family & inheritance tracking** with overwritten_attributes support
|
|
12
|
+
- **Schema discovery** for attributes and search filters
|
|
13
|
+
- **Automatic authentication** with token refresh
|
|
14
|
+
- **Rate limit handling** — proactive pacing to the account's advertised window plus jittered 429/5xx backoff
|
|
15
|
+
- **Zero persistence** — stateless, no database required
|
|
16
|
+
- **Remote server support** — Deploy to Cloudflare Workers for mobile/web access
|
|
17
|
+
|
|
18
|
+
## Installation
|
|
19
|
+
|
|
20
|
+
### Prerequisites
|
|
21
|
+
|
|
22
|
+
- **Node.js 20+**
|
|
23
|
+
- **Plytix PIM account** with API access
|
|
24
|
+
|
|
25
|
+
### Setup
|
|
26
|
+
|
|
27
|
+
1. **Clone and install:**
|
|
28
|
+
```bash
|
|
29
|
+
git clone https://github.com/Supplyline/plytix-mcp.git
|
|
30
|
+
cd plytix-mcp
|
|
31
|
+
npm install
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
2. **Configure credentials:**
|
|
35
|
+
```bash
|
|
36
|
+
cp .env.example .env
|
|
37
|
+
# Edit .env with your Plytix API credentials
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
3. **Build the project:**
|
|
41
|
+
```bash
|
|
42
|
+
npm run build
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Usage
|
|
46
|
+
|
|
47
|
+
### With Claude Desktop
|
|
48
|
+
|
|
49
|
+
Add to your Claude Desktop MCP configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
|
|
50
|
+
|
|
51
|
+
```json
|
|
52
|
+
{
|
|
53
|
+
"mcpServers": {
|
|
54
|
+
"plytix": {
|
|
55
|
+
"command": "node",
|
|
56
|
+
"args": ["/path/to/plytix-mcp/dist/index.js"],
|
|
57
|
+
"env": {
|
|
58
|
+
"PLYTIX_API_KEY": "your_api_key_here",
|
|
59
|
+
"PLYTIX_API_PASSWORD": "your_api_password_here"
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Standalone
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npm start # Production mode
|
|
70
|
+
npm run dev # Development with hot reload
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Remote Server (Cloudflare Workers)
|
|
74
|
+
|
|
75
|
+
Deploy as a remote MCP server for access from Claude mobile app, web clients, or shared team access.
|
|
76
|
+
|
|
77
|
+
### Quick Deploy
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
# Install dependencies (includes wrangler)
|
|
81
|
+
npm install
|
|
82
|
+
|
|
83
|
+
# Login to Cloudflare
|
|
84
|
+
wrangler login
|
|
85
|
+
|
|
86
|
+
# Deploy to Cloudflare Workers
|
|
87
|
+
npm run deploy
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### Using the Remote Server
|
|
91
|
+
|
|
92
|
+
Once deployed, connect from any MCP client using the deployed URL and your Plytix credentials:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# With Claude Desktop (using mcp-remote)
|
|
96
|
+
npx mcp-remote https://plytix-mcp.your-subdomain.workers.dev/mcp \
|
|
97
|
+
--header "X-Plytix-API-Key: YOUR_API_KEY" \
|
|
98
|
+
--header "X-Plytix-API-Password: YOUR_API_PASSWORD"
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Release 0.7.0 exposes 83 tools in the Worker and 88 over stdio. It intentionally omits local-only utilities and filesystem tools: `identifier_detect`, `identifier_normalize`, `match_score`, `products_batch_update_manifest`, and `products_batch_export_to_file`.
|
|
102
|
+
|
|
103
|
+
### Protocol versions
|
|
104
|
+
|
|
105
|
+
The worker is **dual-era**: it serves both the stateless `2026-07-28` revision and the
|
|
106
|
+
older handshake-based revisions on the same endpoint, choosing per request.
|
|
107
|
+
|
|
108
|
+
| Client sends | Served as |
|
|
109
|
+
|---|---|
|
|
110
|
+
| `_meta` with `io.modelcontextprotocol/protocolVersion`, or an `MCP-Protocol-Version` header naming a non-legacy version | `2026-07-28` — mirrored-header validation, `server/discover`, `resultType`/`serverInfo` on results, spec HTTP status codes |
|
|
111
|
+
| `initialize` handshake (`2025-11-25` … `2024-11-05`) | Legacy — responses unchanged from previous releases |
|
|
112
|
+
|
|
113
|
+
A client newer than this server receives `-32022` with the supported list and can
|
|
114
|
+
renegotiate down. The `2026-07-28` transport dropped the standalone `GET` stream and
|
|
115
|
+
`DELETE` teardown, so both now answer `405`; `Mcp-Session-Id` is ignored rather than
|
|
116
|
+
echoed.
|
|
117
|
+
|
|
118
|
+
The stdio server still speaks the legacy handshake — it delegates the protocol to
|
|
119
|
+
`@modelcontextprotocol/sdk`, which has not yet shipped `2026-07-28`.
|
|
120
|
+
|
|
121
|
+
### Local Development
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
npm run dev:worker # Start local worker at localhost:8787
|
|
125
|
+
npm run test:worker # Test the worker endpoints
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
For detailed setup instructions, see [docs/remote-setup.md](docs/remote-setup.md).
|
|
129
|
+
|
|
130
|
+
## Available Tools
|
|
131
|
+
|
|
132
|
+
### Product Tools
|
|
133
|
+
|
|
134
|
+
| Tool | Description |
|
|
135
|
+
|------|-------------|
|
|
136
|
+
| `products_lookup` | Smart lookup by any identifier (auto-detects ID, SKU, MPN, GTIN, label) |
|
|
137
|
+
| `products_get` | Get single product by ID with full details and `overwritten_attributes` |
|
|
138
|
+
| `products_get_full` | Get one product with related family, variants, categories, and assets |
|
|
139
|
+
| `products_search` | Advanced search with filters, pagination, and sorting |
|
|
140
|
+
| `products_find` | Simple multi-criteria search (SKU, MPN, MNO, GTIN, label, fuzzy) |
|
|
141
|
+
| `products_batch_export` | Capped inline product snapshot by search, SKU, or product ID |
|
|
142
|
+
| `products_batch_export_to_file` | Stdio-only JSONL/NDJSON product export under `PLYTIX_MCP_EXPORT_DIR` |
|
|
143
|
+
| `products_create` | Create a new product |
|
|
144
|
+
| `products_update` | Partial update to product fields/attributes |
|
|
145
|
+
| `products_batch_update` | Apply a small guarded product-update batch |
|
|
146
|
+
| `products_batch_update_manifest` | Stdio-only guarded product updates from a local JSON manifest |
|
|
147
|
+
| `products_bulk_update` | Submit up to 1,000 updates as ONE async Plytix bulk job and wait for it to settle (no drift guards; `pending` + `job_id` if the wait budget runs out; stdio also accepts `manifest_path`) |
|
|
148
|
+
| `products_bulk_status` | Poll a bulk job by `job_id`; pass `expected_total` so completion can be confirmed (Plytix reports "Finished" before the summary is populated) |
|
|
149
|
+
| `products_assign_family` | Assign or unassign a product family |
|
|
150
|
+
| `products_delete` | Delete one product (two-step dry run + confirm; `unlink_variants` keeps variants as standalone products) |
|
|
151
|
+
| `products_set_attribute` | Atomic set of one attribute value |
|
|
152
|
+
| `products_clear_attribute` | Atomic clear of one attribute value |
|
|
153
|
+
|
|
154
|
+
### Family Tools
|
|
155
|
+
|
|
156
|
+
| Tool | Description |
|
|
157
|
+
|------|-------------|
|
|
158
|
+
| `families_list` | List or search product families |
|
|
159
|
+
| `families_get` | Get single family with linked attributes |
|
|
160
|
+
| `families_create` | Create a new product family |
|
|
161
|
+
| `families_link_attribute` | Link one or more attributes to a family |
|
|
162
|
+
| `families_unlink_attribute` | Unlink one or more attributes from a family |
|
|
163
|
+
| `families_list_attributes` | List attributes directly linked to a family |
|
|
164
|
+
| `families_list_all_attributes` | List direct and inherited family attributes |
|
|
165
|
+
|
|
166
|
+
### Attribute & Filter Tools
|
|
167
|
+
|
|
168
|
+
| Tool | Description |
|
|
169
|
+
|------|-------------|
|
|
170
|
+
| `attributes_list` | List all attributes (system + custom) with types and options |
|
|
171
|
+
| `attributes_get` | Get full metadata for one attribute label |
|
|
172
|
+
| `attributes_get_options` | Get allowed values for a selectable attribute |
|
|
173
|
+
| `attributes_create` | Create an attribute definition (any type; options, sorting, family links, completeness tracking) |
|
|
174
|
+
| `attributes_update` | Rename, describe, and edit dropdown/multiselect options (`add_options`, `remove_options`, `renamed_options`, or a full `options` list) |
|
|
175
|
+
| `attributes_delete` | Delete an attribute definition (two-step dry run + confirm; refused while a catalog or channel uses it) |
|
|
176
|
+
| `attributes_filters` | Deprecated alias for product filter discovery |
|
|
177
|
+
| `products_filters` | Get product search filter metadata |
|
|
178
|
+
| `assets_filters` | Get asset search filter metadata |
|
|
179
|
+
| `relationships_filters` | Get relationship search filter metadata |
|
|
180
|
+
|
|
181
|
+
### Asset Tools
|
|
182
|
+
|
|
183
|
+
| Tool | Description |
|
|
184
|
+
|------|-------------|
|
|
185
|
+
| `assets_get` | Get one asset by ID |
|
|
186
|
+
| `assets_search` | Search account assets |
|
|
187
|
+
| `assets_update` | Update asset metadata (`filename`, `categories`) |
|
|
188
|
+
| `assets_list` | List assets (images, videos, documents) linked to a product |
|
|
189
|
+
| `assets_link` | Link an asset to a product |
|
|
190
|
+
| `assets_unlink` | Unlink an asset from a product |
|
|
191
|
+
|
|
192
|
+
### Category Tools
|
|
193
|
+
|
|
194
|
+
| Tool | Description |
|
|
195
|
+
|------|-------------|
|
|
196
|
+
| `categories_search` | Search existing categories |
|
|
197
|
+
| `categories_list` | List categories associated with a product |
|
|
198
|
+
| `categories_link` | Link a category to a product |
|
|
199
|
+
| `categories_unlink` | Unlink a category from a product |
|
|
200
|
+
| `categories_create` | Create a root category or a subcategory |
|
|
201
|
+
| `categories_update` | Rename, move (`parent_id`, `""` = root) or reorder children (`sort_children`) |
|
|
202
|
+
| `categories_sort_root` | Reorder the root-level categories |
|
|
203
|
+
| `categories_delete` | Delete a category (two-step dry run + confirm; `move_children_to` rescues the subtree) |
|
|
204
|
+
|
|
205
|
+
### Variant Tools
|
|
206
|
+
|
|
207
|
+
| Tool | Description |
|
|
208
|
+
|------|-------------|
|
|
209
|
+
| `variants_create` | Create a variant under a parent product |
|
|
210
|
+
| `variants_link` | Link an existing product as a variant |
|
|
211
|
+
| `variants_unlink` | Unlink a variant from its parent without deleting it |
|
|
212
|
+
| `variants_list` | List variants for a product |
|
|
213
|
+
| `variants_resync` | Reset variant attributes to inherit parent values |
|
|
214
|
+
|
|
215
|
+
### Relationship Tools
|
|
216
|
+
|
|
217
|
+
| Tool | Description |
|
|
218
|
+
|------|-------------|
|
|
219
|
+
| `relationships_get` | Get a relationship definition by ID |
|
|
220
|
+
| `relationships_search` | Search relationship definitions |
|
|
221
|
+
| `relationships_link_product` | Link one related product row in a relationship |
|
|
222
|
+
| `relationships_unlink_product` | Unlink one related product row in a relationship |
|
|
223
|
+
| `relationships_set_quantity` | Update quantity for one related product row |
|
|
224
|
+
|
|
225
|
+
### Identifier Utilities (Stdio Only)
|
|
226
|
+
|
|
227
|
+
| Tool | Description |
|
|
228
|
+
|------|-------------|
|
|
229
|
+
| `identifier_detect` | Detect identifier type from raw value |
|
|
230
|
+
| `identifier_normalize` | Normalize identifier for matching |
|
|
231
|
+
| `match_score` | Score identifier-product match confidence |
|
|
232
|
+
|
|
233
|
+
The remote worker exposes every tool above except the three identifier utilities in the final section and the two stdio-only filesystem tools: `products_batch_update_manifest` and `products_batch_export_to_file`.
|
|
234
|
+
|
|
235
|
+
## Smart Lookup System
|
|
236
|
+
|
|
237
|
+
The `products_lookup` tool automatically detects identifier types and uses staged search strategies:
|
|
238
|
+
|
|
239
|
+
**Detection priority:**
|
|
240
|
+
1. MongoDB ObjectId (24-char hex) → `id` (confidence: 1.0)
|
|
241
|
+
2. GTIN (8/12/13/14 digits) → `gtin` (confidence: 0.95)
|
|
242
|
+
3. Contains spaces → `label` (confidence: 0.9)
|
|
243
|
+
4. Dashed alphanumeric → `mpn` (confidence: 0.8)
|
|
244
|
+
5. Alphanumeric with separators → `sku` (confidence: 0.7)
|
|
245
|
+
|
|
246
|
+
**Search strategies (in order):**
|
|
247
|
+
1. Direct ID lookup (if detected as ID)
|
|
248
|
+
2. Exact field matches (SKU, GTIN, MPN, MNO)
|
|
249
|
+
3. Text search across multiple fields
|
|
250
|
+
4. Broad LIKE search (last resort)
|
|
251
|
+
|
|
252
|
+
**Example:**
|
|
253
|
+
```
|
|
254
|
+
Input: "LMI-PD-123"
|
|
255
|
+
→ Detected as: sku (confidence: 0.7)
|
|
256
|
+
→ Tries: sku_eq, mpn fields, text_search, broad_like
|
|
257
|
+
→ Returns: best match with confidence score
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
## Inheritance Tracking
|
|
261
|
+
|
|
262
|
+
`products_get` returns the full product by default. For a smaller view of custom
|
|
263
|
+
attributes, pass `attribute_labels: ["short_description", "list_price"]` (at most
|
|
264
|
+
50 exact, unprefixed labels). `[]` selects no custom attribute values. This opt-in
|
|
265
|
+
mode returns `{ product, projection }`; `projection.requested_labels` and
|
|
266
|
+
`projection.missing_labels` distinguish unrequested fields from keys absent in
|
|
267
|
+
the fetched attributes. Explicit null values remain null. Native top-level
|
|
268
|
+
fields and the entire `overwritten_attributes` list remain unchanged. This is
|
|
269
|
+
local display filtering after a full direct GET, not an upstream projection or a
|
|
270
|
+
response-size cap. A projected view is not a complete write/readback baseline.
|
|
271
|
+
|
|
272
|
+
Products return an `overwritten_attributes` array listing which attributes are explicitly set (not inherited from family). Use this with:
|
|
273
|
+
|
|
274
|
+
- `product_family_id` — The family this product belongs to
|
|
275
|
+
- `families_get` — Retrieve family-level default values
|
|
276
|
+
- Compare to determine inherited vs overwritten values
|
|
277
|
+
|
|
278
|
+
## Configuration
|
|
279
|
+
|
|
280
|
+
### Environment Variables
|
|
281
|
+
|
|
282
|
+
| Variable | Required | Default | Description |
|
|
283
|
+
|----------|----------|---------|-------------|
|
|
284
|
+
| `PLYTIX_API_KEY` | ✅ | — | Your Plytix API key |
|
|
285
|
+
| `PLYTIX_API_PASSWORD` | ✅ | — | Your Plytix API password |
|
|
286
|
+
| `PLYTIX_API_BASE` | ❌ | `https://pim.plytix.com` | Plytix API base URL |
|
|
287
|
+
| `PLYTIX_AUTH_URL` | ❌ | `https://auth.plytix.com/auth/api/get-token` | Auth endpoint |
|
|
288
|
+
| `PLYTIX_MPN_LABELS` | ❌ | `["attributes.mpn"]` | JSON array of MPN attribute labels |
|
|
289
|
+
| `PLYTIX_MNO_LABELS` | ❌ | `["attributes.model_no"]` | JSON array of MNO attribute labels |
|
|
290
|
+
| `PLYTIX_MCP_EXPORT_DIR` | ❌ | — | Required only for `products_batch_export_to_file`; limits file exports to this directory |
|
|
291
|
+
| `PLYTIX_MCP_MAX_DELETES` | ❌ | `3` | Deletes one server process (or Worker isolate, via a `[vars]` binding) will perform before refusing further ones. `0` disables deletes entirely. See [Delete safety gate](#delete-safety-gate) |
|
|
292
|
+
|
|
293
|
+
### Delete safety gate
|
|
294
|
+
|
|
295
|
+
`src/safety.ts` provides a two-call gate for the destructive tools
|
|
296
|
+
(`products_delete`, `attributes_delete`, `categories_delete`). A caller first
|
|
297
|
+
invokes the tool with `dry_run: true` and gets back a preview of what would be
|
|
298
|
+
removed plus a `confirm_token`; executing requires calling again with that
|
|
299
|
+
token. Tokens are single-use, scoped to one tool and one target, and expire
|
|
300
|
+
after 5 minutes. A per-process cap (`PLYTIX_MCP_MAX_DELETES`, default 3) bounds
|
|
301
|
+
how much any one session can remove.
|
|
302
|
+
|
|
303
|
+
The execute call must repeat the side-effect options the preview was issued for
|
|
304
|
+
(`unlink_variants` on a product, `move_children_to` on a category), and it is
|
|
305
|
+
refused if the target's variants or children changed since the dry run. Plytix
|
|
306
|
+
deletes a parent's variants and a category's whole subtree; those two options
|
|
307
|
+
unlink the variants (they become standalone products) or move the direct
|
|
308
|
+
children out first, so only the named item is removed. Plytix has no bulk
|
|
309
|
+
product delete, so `products_delete` is one product per call.
|
|
310
|
+
|
|
311
|
+
**What this does and does not protect against.** The token goes back to the
|
|
312
|
+
calling agent, not to a human — an autonomous agent can read it from the
|
|
313
|
+
dry-run response and immediately call again. So the gate is a forced pause with
|
|
314
|
+
a visible preview and a hard ceiling, not a human confirmation step. It stops a
|
|
315
|
+
runaway loop from clearing a catalog; it does not stop an agent that has decided
|
|
316
|
+
to delete something.
|
|
317
|
+
|
|
318
|
+
Genuine human confirmation needs the MCP `elicitInput` capability, where the
|
|
319
|
+
server asks the client to prompt the user. A future revision can elicit when the
|
|
320
|
+
client advertises that capability and fall back to this token flow otherwise.
|
|
321
|
+
|
|
322
|
+
## Development
|
|
323
|
+
|
|
324
|
+
### Scripts
|
|
325
|
+
|
|
326
|
+
| Command | Description |
|
|
327
|
+
|---------|-------------|
|
|
328
|
+
| `npm run dev` | Development server with hot reload (stdio) |
|
|
329
|
+
| `npm run dev:worker` | Development server for Cloudflare Workers |
|
|
330
|
+
| `npm run build` | Build TypeScript to JavaScript |
|
|
331
|
+
| `npm run deploy` | Deploy to Cloudflare Workers |
|
|
332
|
+
| `npm start` | Start production server (stdio) |
|
|
333
|
+
| `npm test` | Run unit tests (vitest) |
|
|
334
|
+
| `npm run test:watch` | Run tests in watch mode |
|
|
335
|
+
| `npm run test:mcp` | Test MCP protocol handshake |
|
|
336
|
+
| `npm run test:worker` | Test worker endpoints |
|
|
337
|
+
| `npm run test:all` | Build + unit + integration + MCP tests |
|
|
338
|
+
| `npm run typecheck` | Type check without building |
|
|
339
|
+
|
|
340
|
+
### Architecture
|
|
341
|
+
|
|
342
|
+
```
|
|
343
|
+
src/
|
|
344
|
+
index.ts # MCP server entry point (stdio transport)
|
|
345
|
+
worker.ts # Cloudflare Worker entry point (HTTP transport)
|
|
346
|
+
client.ts # Plytix API client with auth & rate limiting
|
|
347
|
+
worker-client.ts # Worker-compatible client (BYOK credentials)
|
|
348
|
+
worker-lookup.ts # Worker-compatible smart lookup
|
|
349
|
+
types.ts # TypeScript types
|
|
350
|
+
lookup/
|
|
351
|
+
identifier.ts # Identifier type detection
|
|
352
|
+
lookup.ts # Smart lookup with staged search
|
|
353
|
+
tools/
|
|
354
|
+
products.ts # Product tools (lookup, get, search, find, write ops)
|
|
355
|
+
families.ts # Family tools (list, get, create, attribute membership)
|
|
356
|
+
attributes.ts # Attribute metadata + filter discovery tools
|
|
357
|
+
product-attributes.ts # Atomic product attribute write tools
|
|
358
|
+
assets.ts # Asset get/search/update + product asset link tools
|
|
359
|
+
categories.ts # Category search + product category link tools
|
|
360
|
+
variants.ts # Variant lifecycle tools
|
|
361
|
+
relationships.ts # Relationship discovery + product relationship write tools
|
|
362
|
+
extensions/ # Optional deployment-specific customizations
|
|
363
|
+
wrangler.toml # Cloudflare Workers configuration
|
|
364
|
+
docs/
|
|
365
|
+
remote-setup.md # Remote server setup guide
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
### Design Principles
|
|
369
|
+
|
|
370
|
+
This MCP server is intentionally **stateless and lightweight**:
|
|
371
|
+
|
|
372
|
+
- **No database** — All queries go directly to Plytix API
|
|
373
|
+
- **No sync/caching layer** — Fresh data on every request
|
|
374
|
+
- **No background jobs** — Request/response only
|
|
375
|
+
- **Ephemeral in-memory cache** — Brief (60s) request deduplication, cleared on restart
|
|
376
|
+
|
|
377
|
+
For ETL, sync, or persistent caching needs, pair this server with a separate persistence layer.
|
|
378
|
+
|
|
379
|
+
## License
|
|
380
|
+
|
|
381
|
+
MIT License — see [LICENSE](LICENSE) file for details.
|
|
382
|
+
|
|
383
|
+
## Support
|
|
384
|
+
|
|
385
|
+
- **Issues**: [GitHub Issues](https://github.com/Supplyline/plytix-mcp/issues)
|
|
386
|
+
- **Plytix API**: [Plytix Documentation](https://docs.plytix.com/)
|
|
387
|
+
- **MCP Protocol**: [Model Context Protocol](https://modelcontextprotocol.io/)
|
|
388
|
+
|
|
389
|
+
## Catalog inspection and family levels
|
|
390
|
+
|
|
391
|
+
On stdio and the Worker, use `families_get_attribute_level` with a family ID and attribute label. To preview an edit call `families_set_attribute_level` with the same identity, `level: "variant_level"`, `expected_level: "parent_level"` and `dry_run: true`. Execute with dry run off and check the returned outcome. Explicitly supplying a level to `families_link_attribute` resolves new links by ID. Review descendant product values separately before a migration.
|
|
392
|
+
|
|
393
|
+
Use `relationships_get_link` for an exact source, destination and relationship type. For reverse lookup, pass `to_product_id` to `relationships_search_links`. Include `relationship_type_id` to narrow the search. Keep the filters and pass the returned `next` object as `cursor` until it is null, even after an empty page. With no type or source, each call visits at most one definition and one source product. Reverse lookups use the V1 index for nonnegative quantities. Concurrent catalog edits may change page ordering.
|
|
394
|
+
|
|
395
|
+
Use `attribute_groups_search` and `attribute_groups_get` to inspect group membership. V1 documents whole-roster replacement and provides no proven conditional update for adding or removing one member. Those two writes remain open.
|
|
396
|
+
|
|
397
|
+
Pass `response_mode: "projected"` and an explicit `attributes` array to `products_search` for per-field states and separate page, match and catalog counts. A native null is indeterminate in search. Use a by-ID read to establish its value.
|
|
398
|
+
|
|
399
|
+
## Catalog administration in 0.7.0
|
|
400
|
+
|
|
401
|
+
| Task | Community tool and input |
|
|
402
|
+
|---|---|
|
|
403
|
+
| Inspect a SKU | `products_get_by_sku` accepts an exact `sku` and optional `attribute_labels`. It checks the SKU again on canonical ID readback. |
|
|
404
|
+
| Inspect definitions and family associations | Use `attributes_get_by_id`, `attributes_search` and `families_search_attributes`. Association pages return direct levels and a continuation cursor. |
|
|
405
|
+
| Upload a DAM file | Pass a public HTTP(S) `url` or raw base64 `content` plus `filename` to `assets_create`. The encoded text limit is 4 MiB. The response identifies the created asset and its verification outcome. |
|
|
406
|
+
| Attach a thumbnail when creating a product | Pass an existing asset's ID as `thumbnail_id` to `products_create`; the server reads the product back and checks the linked asset. |
|
|
407
|
+
| Maintain categories | `asset_categories_search/get/create/update/delete` cover the DAM tree. `categories_get` reads a product category and `categories_get_membership` looks up its association with a product. |
|
|
408
|
+
| Maintain catalog definitions | `attribute_groups_create/update` accept name and zero-based order. `relationship_types_create/update` accept display name. `families_update` renames a family. |
|
|
409
|
+
| Remove catalog records | `families_delete`, `assets_delete`, `asset_categories_delete`, `attribute_groups_delete` and `relationship_types_delete` accept `id`. Request `dry_run: true`, review dependencies, then submit the returned `confirm_token`. Uncertain submissions count toward the current process cap. |
|
|
410
|
+
|
|
411
|
+
If a write returns `unverified`, use its canonical ID to reconcile before submitting again. With a lost create response, search by the identifying input first. The coverage table records supported fields, open operations and upstream dependencies for each official tool. [Official beta coverage](docs/official-beta-parity.md)
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bulk product updates over Plytix's async job endpoint.
|
|
3
|
+
*
|
|
4
|
+
* POST /api/v1/bulk/products → job record (≤ 1,000 rows, returns at once)
|
|
5
|
+
* GET /api/v1/bulk/products/<job_id> → job summary (status, counters, per-row errors)
|
|
6
|
+
*
|
|
7
|
+
* Shared by the stdio and Worker clients; keep it free of Node-only imports.
|
|
8
|
+
*
|
|
9
|
+
* Two facts about the endpoint drive the shape of this module (both verified live,
|
|
10
|
+
* see docs/features/batch-update/REST-EVIDENCE.md, 2026-09-15):
|
|
11
|
+
*
|
|
12
|
+
* 1. The job reports `status: "Finished"` BEFORE its summary and product list are
|
|
13
|
+
* populated. A caller that stops at "Finished" sees `ok: 0` on a fully successful job.
|
|
14
|
+
* So "settled" here is decided by the COUNTERS: the job is done when ok+error+cancelled
|
|
15
|
+
* account for every submitted row, whatever the status string says (the status
|
|
16
|
+
* vocabulary has already drifted from Plytix's own draft doc). A failure-class status is
|
|
17
|
+
* terminal on its own. The status string is reported, never trusted for completion.
|
|
18
|
+
* 2. There is no optimistic-concurrency guard. A bulk job writes over whatever is live.
|
|
19
|
+
* Items that carry `expected_attributes` / `if_match` are rejected up front rather than
|
|
20
|
+
* silently stripped — use `products_batch_update` when a guard is needed.
|
|
21
|
+
*/
|
|
22
|
+
import type { BatchUpdateItem, BatchUpdateMetadata, BulkJobCounters, BulkJobRecord, BulkJobSummary, BulkProductRow, BulkUpdateResult } from '../types.js';
|
|
23
|
+
/** Plytix's documented per-job cap. */
|
|
24
|
+
export declare const BULK_MAX_ITEMS = 1000;
|
|
25
|
+
/**
|
|
26
|
+
* How long a submit call will wait for the job to settle before handing back a `pending`
|
|
27
|
+
* result. Kept under a typical MCP client timeout; `products_bulk_status` picks up from there.
|
|
28
|
+
*/
|
|
29
|
+
export declare const BULK_DEFAULT_WAIT_TIMEOUT_MS = 45000;
|
|
30
|
+
/** Hard ceiling on any wait, whatever the caller asks for. Polling is a subrequest each time. */
|
|
31
|
+
export declare const BULK_MAX_WAIT_TIMEOUT_MS = 120000;
|
|
32
|
+
/**
|
|
33
|
+
* Ceiling on the serialized request body for one job. The server's own limit is unknown;
|
|
34
|
+
* a 620-row manifest measured ~1.5 MB, so this leaves room without letting a 32 MB manifest
|
|
35
|
+
* through as a single POST.
|
|
36
|
+
*/
|
|
37
|
+
export declare const BULK_MAX_BODY_BYTES: number;
|
|
38
|
+
/**
|
|
39
|
+
* Thrown when the submit call fails. `ambiguous` means the request may have reached Plytix
|
|
40
|
+
* and created the job anyway (5xx, timeout, connection reset): there is no job-listing
|
|
41
|
+
* endpoint, so the caller must check the products before resubmitting. A 429 (not
|
|
42
|
+
* processed) or a definitive 4xx rejection is not ambiguous.
|
|
43
|
+
*
|
|
44
|
+
* `safeMessage` carries the guidance WITHOUT the upstream response body, for surfaces that
|
|
45
|
+
* must not echo raw upstream text to remote callers (the Worker's error sanitizer).
|
|
46
|
+
*/
|
|
47
|
+
export declare class BulkSubmitError extends Error {
|
|
48
|
+
readonly cause: unknown;
|
|
49
|
+
readonly status?: number;
|
|
50
|
+
readonly ambiguous: boolean;
|
|
51
|
+
readonly safeMessage: string;
|
|
52
|
+
constructor(safeMessage: string, detail: string, cause: unknown);
|
|
53
|
+
}
|
|
54
|
+
/** 429 → not processed; other 4xx (bar 408) → rejected before any job existed; else unknown. */
|
|
55
|
+
export declare function isAmbiguousSubmitStatus(status: number | undefined): boolean;
|
|
56
|
+
export interface BulkUpdateOperations {
|
|
57
|
+
submitBulkProductUpdate(rows: BulkProductRow[]): Promise<BulkJobRecord>;
|
|
58
|
+
getBulkProductJob(jobId: string): Promise<BulkJobSummary>;
|
|
59
|
+
}
|
|
60
|
+
interface ClockOptions {
|
|
61
|
+
now?: () => number;
|
|
62
|
+
sleep?: (ms: number) => Promise<void>;
|
|
63
|
+
}
|
|
64
|
+
export interface ExecuteBulkUpdateOptions extends ClockOptions {
|
|
65
|
+
maxItems: number;
|
|
66
|
+
maxBytes?: number;
|
|
67
|
+
dryRun?: boolean;
|
|
68
|
+
/** Poll the job after submitting (default true). `false` returns `pending` immediately. */
|
|
69
|
+
wait?: boolean;
|
|
70
|
+
waitTimeoutMs?: number;
|
|
71
|
+
returnSuccesses?: boolean;
|
|
72
|
+
metadata?: BatchUpdateMetadata;
|
|
73
|
+
}
|
|
74
|
+
export interface PollBulkJobOptions extends ClockOptions {
|
|
75
|
+
/** Rows the job was submitted with. Without it, completion cannot be confirmed. */
|
|
76
|
+
submitted?: number;
|
|
77
|
+
/** Keep polling until settled or the budget runs out (default false: one snapshot). */
|
|
78
|
+
wait?: boolean;
|
|
79
|
+
waitTimeoutMs?: number;
|
|
80
|
+
returnSuccesses?: boolean;
|
|
81
|
+
metadata?: BatchUpdateMetadata;
|
|
82
|
+
/** The submitted items, so failures/successes can carry the caller's row index. */
|
|
83
|
+
items?: BatchUpdateItem[];
|
|
84
|
+
}
|
|
85
|
+
/** Build the request rows. `product_id` wins over `sku`; only defined data keys are sent. */
|
|
86
|
+
export declare function toBulkRows(items: BatchUpdateItem[]): BulkProductRow[];
|
|
87
|
+
/** Counters arrive as strings (`"4"`); anything unparsable counts as zero. */
|
|
88
|
+
export declare function normalizeCounters(summary: BulkJobSummary | undefined): BulkJobCounters;
|
|
89
|
+
/**
|
|
90
|
+
* true — every submitted row is accounted for by the counters (whatever the status string
|
|
91
|
+
* says — Plytix's vocabulary has already drifted from its own draft doc, so the
|
|
92
|
+
* counters are the stronger signal), or the job ended in a failure state.
|
|
93
|
+
* false — not yet (still running, or "Finished" with counters lagging).
|
|
94
|
+
* null — finished but `submitted` is unknown, so completeness cannot be judged.
|
|
95
|
+
*/
|
|
96
|
+
export declare function isBulkJobSettled(summary: BulkJobSummary, submitted: number | undefined): boolean | null;
|
|
97
|
+
export declare function pollBulkJob(ops: BulkUpdateOperations, jobId: string, options?: PollBulkJobOptions): Promise<BulkUpdateResult>;
|
|
98
|
+
export declare function executeBulkUpdate(ops: BulkUpdateOperations, input: unknown, options: ExecuteBulkUpdateOptions): Promise<BulkUpdateResult>;
|
|
99
|
+
export {};
|
|
100
|
+
//# sourceMappingURL=bulk.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../src/batch/bulk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAGV,eAAe,EACf,mBAAmB,EAGnB,eAAe,EAEf,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AASrB,uCAAuC;AACvC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,iGAAiG;AACjG,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AAInD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAIyB,KAAK,EAAE,OAAO;IAH/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBACjB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAkB,KAAK,EAAE,OAAO;CAQhF;AAED,gGAAgG;AAChG,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI3E;AAED,MAAM,WAAW,oBAAoB;IACnC,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3D;AAED,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,mFAAmF;IACnF,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B;AAMD,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,cAAc,EAAE,CAQrE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,eAAe,CAUtF;AAYD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,GAAG,IAAI,CAShB;AA+JD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAoCD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAmF3B"}
|