@retailcrm/embed-ui-v1-contexts 0.9.23-alpha.2 → 0.9.23

package/dist/mcp/server.cjs

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const fs = require("node:fs");
+const process = require("node:process");
+const node_url = require("node:url");
+const node_path = require("node:path");
+const mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
+var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const fs__namespace = /* @__PURE__ */ _interopNamespaceDefault(fs);
+const packageRoot = node_path.resolve(node_path.dirname(node_url.fileURLToPath(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("server.cjs", document.baseURI).href)), "../..");
+const packageJson = node_path.join(packageRoot, "package.json");
+const groups = [{
+  kind: "contexts",
+  indexUri: "embed-ui-v1-contexts://contexts",
+  title: "v1-contexts predefined contexts index",
+  description: "Machine-readable index of predefined context profiles provided by @retailcrm/embed-ui-v1-contexts.",
+  profileTitle: (id) => `Context ${id}`,
+  profileDescription: (id) => `AI-friendly YAML profile for predefined context ${id}.`
+}, {
+  kind: "actions",
+  indexUri: "embed-ui-v1-contexts://actions",
+  title: "v1-contexts action scopes index",
+  description: "Machine-readable index of action scope profiles provided by @retailcrm/embed-ui-v1-contexts.",
+  profileTitle: (id) => `Action scope ${id}`,
+  profileDescription: (id) => `AI-friendly YAML profile for action scope ${id}.`
+}, {
+  kind: "custom-contexts",
+  indexUri: "embed-ui-v1-contexts://custom-contexts",
+  title: "v1-contexts custom contexts index",
+  description: "Machine-readable index of custom context profiles provided by @retailcrm/embed-ui-v1-contexts.",
+  profileTitle: (id) => `Custom context ${id}`,
+  profileDescription: (id) => `AI-friendly YAML profile for custom context entity ${id}.`
+}];
+const readPackageVersion = () => {
+  const content = fs__namespace.readFileSync(packageJson, "utf8");
+  return JSON.parse(content).version;
+};
+const readIndex = (kind) => {
+  const index = node_path.join(packageRoot, "docs", kind, "index.json");
+  if (!fs__namespace.existsSync(index)) {
+    return {
+      package: "@retailcrm/embed-ui-v1-contexts",
+      resources: []
+    };
+  }
+  return JSON.parse(fs__namespace.readFileSync(index, "utf8"));
+};
+const readProfileResources = (kind) => {
+  return readIndex(kind).resources.map((resource) => ({
+    ...resource,
+    content: fs__namespace.readFileSync(node_path.join(packageRoot, resource.file), "utf8")
+  }));
+};
+const waitForCloseSignal = () => {
+  const keepAlive = setInterval(() => void 0, 2 ** 31 - 1);
+  process.stdin.resume();
+  return new Promise((resolve2) => {
+    const close = () => {
+      clearInterval(keepAlive);
+      resolve2();
+    };
+    process.once("SIGINT", close);
+    process.once("SIGTERM", close);
+  });
+};
+const createContextsMcpServer = () => {
+  const server = new mcp_js.McpServer({
+    name: "@retailcrm/embed-ui-v1-contexts",
+    version: readPackageVersion()
+  });
+  const compatibilityTool = server.registerTool("mcp-compatibility-noop", {
+    description: "Disabled compatibility tool used only to make tools/list return an empty list for clients that probe it."
+  }, () => ({
+    content: []
+  }));
+  const compatibilityPrompt = server.registerPrompt("mcp-compatibility-noop", {
+    description: "Disabled compatibility prompt used only to make prompts/list return an empty list for clients that probe it."
+  }, () => ({
+    messages: []
+  }));
+  compatibilityTool.disable();
+  compatibilityPrompt.disable();
+  for (const group of groups) {
+    const resources = readProfileResources(group.kind);
+    server.registerResource(`v1-contexts ${group.kind} index`, group.indexUri, {
+      title: group.title,
+      description: group.description,
+      mimeType: "application/json"
+    }, (uri) => ({
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify({
+          package: "@retailcrm/embed-ui-v1-contexts",
+          resources: resources.map((resource) => ({
+            id: resource.id,
+            uri: resource.uri,
+            file: resource.file
+          }))
+        }, null, 2)
+      }]
+    }));
+    for (const resource of resources) {
+      server.registerResource(`v1-contexts ${group.kind} ${resource.id}`, resource.uri, {
+        title: group.profileTitle(resource.id),
+        description: group.profileDescription(resource.id),
+        mimeType: "application/yaml",
+        annotations: {
+          audience: ["assistant"],
+          priority: 0.8
+        }
+      }, (uri) => ({
+        contents: [{
+          uri: uri.href,
+          mimeType: "application/yaml",
+          text: resource.content
+        }]
+      }));
+    }
+  }
+  return server;
+};
+const runContextsMcpServer = async () => {
+  const server = createContextsMcpServer();
+  await server.connect(new stdio_js.StdioServerTransport());
+  await waitForCloseSignal();
+  await server.close();
+};
+exports.createContextsMcpServer = createContextsMcpServer;
+exports.runContextsMcpServer = runContextsMcpServer;

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const createContextsMcpServer: () => McpServer;
+export declare const runContextsMcpServer: () => Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,129 @@
+import * as fs from "node:fs";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { resolve, dirname, join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+const packageJson = join(packageRoot, "package.json");
+const groups = [{
+  kind: "contexts",
+  indexUri: "embed-ui-v1-contexts://contexts",
+  title: "v1-contexts predefined contexts index",
+  description: "Machine-readable index of predefined context profiles provided by @retailcrm/embed-ui-v1-contexts.",
+  profileTitle: (id) => `Context ${id}`,
+  profileDescription: (id) => `AI-friendly YAML profile for predefined context ${id}.`
+}, {
+  kind: "actions",
+  indexUri: "embed-ui-v1-contexts://actions",
+  title: "v1-contexts action scopes index",
+  description: "Machine-readable index of action scope profiles provided by @retailcrm/embed-ui-v1-contexts.",
+  profileTitle: (id) => `Action scope ${id}`,
+  profileDescription: (id) => `AI-friendly YAML profile for action scope ${id}.`
+}, {
+  kind: "custom-contexts",
+  indexUri: "embed-ui-v1-contexts://custom-contexts",
+  title: "v1-contexts custom contexts index",
+  description: "Machine-readable index of custom context profiles provided by @retailcrm/embed-ui-v1-contexts.",
+  profileTitle: (id) => `Custom context ${id}`,
+  profileDescription: (id) => `AI-friendly YAML profile for custom context entity ${id}.`
+}];
+const readPackageVersion = () => {
+  const content = fs.readFileSync(packageJson, "utf8");
+  return JSON.parse(content).version;
+};
+const readIndex = (kind) => {
+  const index = join(packageRoot, "docs", kind, "index.json");
+  if (!fs.existsSync(index)) {
+    return {
+      package: "@retailcrm/embed-ui-v1-contexts",
+      resources: []
+    };
+  }
+  return JSON.parse(fs.readFileSync(index, "utf8"));
+};
+const readProfileResources = (kind) => {
+  return readIndex(kind).resources.map((resource) => ({
+    ...resource,
+    content: fs.readFileSync(join(packageRoot, resource.file), "utf8")
+  }));
+};
+const waitForCloseSignal = () => {
+  const keepAlive = setInterval(() => void 0, 2 ** 31 - 1);
+  process.stdin.resume();
+  return new Promise((resolve2) => {
+    const close = () => {
+      clearInterval(keepAlive);
+      resolve2();
+    };
+    process.once("SIGINT", close);
+    process.once("SIGTERM", close);
+  });
+};
+const createContextsMcpServer = () => {
+  const server = new McpServer({
+    name: "@retailcrm/embed-ui-v1-contexts",
+    version: readPackageVersion()
+  });
+  const compatibilityTool = server.registerTool("mcp-compatibility-noop", {
+    description: "Disabled compatibility tool used only to make tools/list return an empty list for clients that probe it."
+  }, () => ({
+    content: []
+  }));
+  const compatibilityPrompt = server.registerPrompt("mcp-compatibility-noop", {
+    description: "Disabled compatibility prompt used only to make prompts/list return an empty list for clients that probe it."
+  }, () => ({
+    messages: []
+  }));
+  compatibilityTool.disable();
+  compatibilityPrompt.disable();
+  for (const group of groups) {
+    const resources = readProfileResources(group.kind);
+    server.registerResource(`v1-contexts ${group.kind} index`, group.indexUri, {
+      title: group.title,
+      description: group.description,
+      mimeType: "application/json"
+    }, (uri) => ({
+      contents: [{
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify({
+          package: "@retailcrm/embed-ui-v1-contexts",
+          resources: resources.map((resource) => ({
+            id: resource.id,
+            uri: resource.uri,
+            file: resource.file
+          }))
+        }, null, 2)
+      }]
+    }));
+    for (const resource of resources) {
+      server.registerResource(`v1-contexts ${group.kind} ${resource.id}`, resource.uri, {
+        title: group.profileTitle(resource.id),
+        description: group.profileDescription(resource.id),
+        mimeType: "application/yaml",
+        annotations: {
+          audience: ["assistant"],
+          priority: 0.8
+        }
+      }, (uri) => ({
+        contents: [{
+          uri: uri.href,
+          mimeType: "application/yaml",
+          text: resource.content
+        }]
+      }));
+    }
+  }
+  return server;
+};
+const runContextsMcpServer = async () => {
+  const server = createContextsMcpServer();
+  await server.connect(new StdioServerTransport());
+  await waitForCloseSignal();
+  await server.close();
+};
+export {
+  createContextsMcpServer,
+  runContextsMcpServer
+};

package/dist/meta.json

@@ -1570,9 +1570,9 @@
           "name": "image.workers",
           "type": "Array<string>",
           "description": {
-            "en-GB": "A list of servers that process images.",
-            "es-ES": "Una lista de servidores que procesan imágenes.",
-            "ru-RU": "Список серверов, обрабатывающих изображения."
+            "en-GB": "List of image preview worker hosts used to build resized or cropped image URLs.",
+            "es-ES": "Lista de hosts de workers de previsualización de imágenes usados para crear URLs de imágenes redimensionadas o recortadas.",
+            "ru-RU": "Список host-ов image preview workers для построения URL уменьшенных или обрезанных изображений."
           },
           "readonly": true
         },

package/docs/actions/index.json

@@ -0,0 +1,10 @@
+{
+  "package": "@retailcrm/embed-ui-v1-contexts",
+  "resources": [
+    {
+      "id": "order/card",
+      "uri": "embed-ui-v1-contexts://actions/order%2Fcard",
+      "file": "docs/actions/order-card.yml"
+    }
+  ]
+}

package/docs/actions/order-card.yml

@@ -0,0 +1,107 @@
+"action_scope": "order/card"
+"summary": "Order card actions for mutating order items through the host form contract."
+"language": "en-GB"
+"audience": "ai"
+"actions":
+  -
+    "name": "createItem"
+    "arguments":
+      -
+        "name": "input"
+        "type": "CreateOrderItemInput"
+    "returns": "Promise<number>"
+    "description": "Creates and adds a new item to the order"
+    "mutates":
+      - "items"
+    "ai_notes":
+      - "Use when a widget needs to add a product or service to the order form."
+  -
+    "name": "changeItemPrice"
+    "arguments":
+      -
+        "name": "index"
+        "type": "number"
+      -
+        "name": "amount"
+        "type": "number"
+    "returns": "Promise<void>"
+    "description": "Changes the price value of an item"
+    "mutates":
+      - "items[].initialPrice"
+    "ai_notes":
+      - "Use with OrderItem.index when changing item price."
+  -
+    "name": "changeItemPriceType"
+    "arguments":
+      -
+        "name": "index"
+        "type": "number"
+      -
+        "name": "code"
+        "type": "string|null"
+    "returns": "Promise<void>"
+    "description": "Changes the price type value of an item, changes the price if the new price type is not empty"
+    "mutates":
+      - "items[].priceType"
+    "ai_notes":
+      - "Use with OrderItem.index when changing item price type."
+  -
+    "name": "changeItemDiscount"
+    "arguments":
+      -
+        "name": "index"
+        "type": "number"
+      -
+        "name": "discount"
+        "type": "{ amount: number|undefined, percent: number|undefined }"
+    "returns": "Promise<void>"
+    "description": "Changes the discount value of an item"
+    "mutates":
+      - "items[].discounts"
+      - "items[].discountTotal"
+    "ai_notes":
+      - "Use with OrderItem.index when changing item discount."
+  -
+    "name": "changeItemQuantity"
+    "arguments":
+      -
+        "name": "index"
+        "type": "number"
+      -
+        "name": "quantity"
+        "type": "number"
+    "returns": "Promise<void>"
+    "description": "Changes the quantity of an item"
+    "mutates":
+      - "items[].quantity"
+    "ai_notes":
+      - "Use with OrderItem.index when changing item quantity."
+  -
+    "name": "changeItemStatus"
+    "arguments":
+      -
+        "name": "index"
+        "type": "number"
+      -
+        "name": "statusCode"
+        "type": "string"
+    "returns": "Promise<void>"
+    "description": "Changes the status of an item by specified identifier"
+    "mutates":
+      - "items[].status"
+    "ai_notes":
+      - "Use with OrderItem.index when changing item status."
+  -
+    "name": "removeItem"
+    "arguments":
+      -
+        "name": "index"
+        "type": "number"
+    "returns": "Promise<void>"
+    "description": "Removes an item from the order"
+    "mutates":
+      - "items"
+    "ai_notes":
+      - "Use with OrderItem.index when removing an item from the order."
+"ai_notes":
+  - "Use actions for host-mediated mutations that cannot be performed by direct context field writes."

package/docs/contexts/customer-card-phone.yml

@@ -0,0 +1,37 @@
+"context": "customer/card:phone"
+"summary": "Readonly context for a single customer phone row target with phone value and row index."
+"language": "en-GB"
+"audience": "ai"
+"public_import":
+  "usage_import": "import { useContext } from '@retailcrm/embed-ui-v1-contexts/remote/customer/card-phone'"
+  "usage_call": "const phone = useContext()"
+"fields":
+  -
+    "name": "value"
+    "type": "string"
+    "readonly": true
+    "description": "Customer phone"
+    "source_of_truth": "Phone number value for the phone row where the widget is mounted."
+    "mutation":
+      "mode": "readonly"
+      "notes": "Readonly context field; use it for reading and UI calculations."
+    "related_actions": []
+    "ai_notes": []
+  -
+    "name": "index"
+    "type": "number"
+    "readonly": true
+    "description": "Serial number of the phone in the list"
+    "source_of_truth": "Zero-based position of the phone row inside the customer phone list."
+    "mutation":
+      "mode": "readonly"
+      "notes": "Readonly context field; use it for reading and UI calculations."
+    "related_actions": []
+    "ai_notes": []
+"field_groups": []
+"types": []
+"usage":
+  "import": "import { useContext } from '@retailcrm/embed-ui-v1-contexts/remote/customer/card-phone'"
+  "call": "const phone = useContext()"
+"related_actions": []
+"ai_notes": []

package/docs/contexts/customer-card.yml

@@ -0,0 +1,59 @@
+"context": "customer/card"
+"summary": "Readonly customer card context with customer identifiers, primary email, and phone list."
+"language": "en-GB"
+"audience": "ai"
+"public_import":
+  "usage_import": "import { useContext } from '@retailcrm/embed-ui-v1-contexts/remote/customer/card'"
+  "usage_call": "const customer = useContext()"
+"fields":
+  -
+    "name": "id"
+    "type": "number|null"
+    "readonly": true
+    "description": "Customer ID"
+    "source_of_truth": "CRM customer identifier for the opened customer card."
+    "mutation":
+      "mode": "readonly"
+      "notes": "Readonly context field; use it for reading and UI calculations."
+    "related_actions": []
+    "ai_notes": []
+  -
+    "name": "externalId"
+    "type": "string"
+    "readonly": true
+    "description": "Customer external ID"
+    "source_of_truth": "External customer identifier from the source system."
+    "mutation":
+      "mode": "readonly"
+      "notes": "Readonly context field; use it for reading and UI calculations."
+    "related_actions": []
+    "ai_notes": []
+  -
+    "name": "email"
+    "type": "string"
+    "readonly": true
+    "description": "Customer email"
+    "mutation":
+      "mode": "readonly"
+      "notes": "Readonly context field; use it for reading and UI calculations."
+    "related_actions": []
+    "ai_notes":
+      - "Use as the current customer email shown on the customer card; it is not a writable order-form field."
+  -
+    "name": "phones"
+    "type": "Array<string>"
+    "readonly": true
+    "description": "Customer phone list"
+    "mutation":
+      "mode": "readonly"
+      "notes": "Readonly context field; use it for reading and UI calculations."
+    "related_actions": []
+    "ai_notes":
+      - "Use for customer-card phone display and selection logic. For a widget attached to one phone row, prefer the customer/card:phone context."
+"field_groups": []
+"types": []
+"usage":
+  "import": "import { useContext } from '@retailcrm/embed-ui-v1-contexts/remote/customer/card'"
+  "call": "const customer = useContext()"
+"related_actions": []
+"ai_notes": []

package/docs/contexts/index.json

@@ -0,0 +1,35 @@
+{
+  "package": "@retailcrm/embed-ui-v1-contexts",
+  "resources": [
+    {
+      "id": "customer/card",
+      "uri": "embed-ui-v1-contexts://contexts/customer%2Fcard",
+      "file": "docs/contexts/customer-card.yml"
+    },
+    {
+      "id": "customer/card:phone",
+      "uri": "embed-ui-v1-contexts://contexts/customer%2Fcard%3Aphone",
+      "file": "docs/contexts/customer-card-phone.yml"
+    },
+    {
+      "id": "order/card",
+      "uri": "embed-ui-v1-contexts://contexts/order%2Fcard",
+      "file": "docs/contexts/order-card.yml"
+    },
+    {
+      "id": "order/card:settings",
+      "uri": "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings",
+      "file": "docs/contexts/order-card-settings.yml"
+    },
+    {
+      "id": "user/current",
+      "uri": "embed-ui-v1-contexts://contexts/user%2Fcurrent",
+      "file": "docs/contexts/user-current.yml"
+    },
+    {
+      "id": "settings",
+      "uri": "embed-ui-v1-contexts://contexts/settings",
+      "file": "docs/contexts/settings.yml"
+    }
+  ]
+}