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

package/bin/embed-ui-v1-endpoint.mjs

@@ -7,7 +7,10 @@ import process from 'node:process'
 const PACKAGE_NAME = '@retailcrm/embed-ui-v1-endpoint'
 const DEFAULT_NEWLINE = '\n'
 const AGENTS_SECTION_HEADER = '## @retailcrm/embed-ui-v1-endpoint'
-const README_MCP_SECTION_HEADER = '## MCP For AI Assistants'
+const AGENTS_SECTION_START = '<!-- embed-ui-agents:@retailcrm/embed-ui-v1-endpoint:start -->'
+const AGENTS_SECTION_END = '<!-- embed-ui-agents:@retailcrm/embed-ui-v1-endpoint:end -->'
+const README_MCP_SECTION_HEADER = '## MCP For AI Assistants: @retailcrm/embed-ui-v1-endpoint'
+const LEGACY_README_MCP_SECTION_HEADER = '## MCP For AI Assistants'
 const README_MCP_MARKER = 'embed-ui-v1-endpoint://targets'
 const MCP_SERVER_NAME = 'retailcrm-embed-ui-v1-endpoint'
 const MCP_BIN_NAME = process.platform === 'win32' ? 'embed-ui-v1-endpoint-mcp.cmd' : 'embed-ui-v1-endpoint-mcp'
@@ -140,7 +143,8 @@ const parseArgs = (argv) => {
 }
 
 const createAgentsSection = () => {
-  return `${AGENTS_SECTION_HEADER}
+  return `${AGENTS_SECTION_START}
+${AGENTS_SECTION_HEADER}
 
 When working with \`${PACKAGE_NAME}\` in this project:
 
@@ -164,6 +168,7 @@ Suggested MCP stdio server configuration:
   "command": "${CLAUDE_PROJECT_MCP_BIN_PATH}"
 }
 \`\`\`
+${AGENTS_SECTION_END}
 `
 }
 
@@ -258,7 +263,26 @@ const createAgentsTemplate = () => {
 ${createAgentsSection()}` + DEFAULT_NEWLINE
 }
 
-const hasPackageSection = (content) => content.includes(AGENTS_SECTION_HEADER)
+const findMarkedSectionRange = (content) => {
+  const start = content.indexOf(AGENTS_SECTION_START)
+  const end = content.indexOf(AGENTS_SECTION_END, start + AGENTS_SECTION_START.length)
+
+  if (start === -1 && end === -1) {
+    return null
+  }
+
+  if (start === -1 || end === -1) {
+    throw new Error(`AGENTS.md contains an incomplete ${PACKAGE_NAME} managed section marker pair`)
+  }
+
+  return {
+    start,
+    end: end + AGENTS_SECTION_END.length,
+  }
+}
+
+const hasPackageSection = (content) =>
+  content.includes(AGENTS_SECTION_START) || content.includes(AGENTS_SECTION_HEADER)
 
 const appendSection = (content, section) => {
   const trimmed = content.replace(/\s+$/u, '')
@@ -271,6 +295,13 @@ const appendSection = (content, section) => {
 }
 
 const replaceSection = (content, section) => {
+  const markedRange = findMarkedSectionRange(content)
+
+  if (markedRange) {
+    return `${content.slice(0, markedRange.start)}${section.trimEnd()}${content.slice(markedRange.end)}`
+      .replace(/\s+$/u, '') + DEFAULT_NEWLINE
+  }
+
   const escapedHeader = AGENTS_SECTION_HEADER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
   const sectionPattern = new RegExp(`${escapedHeader}[\\s\\S]*?(?=\\n##\\s|$)`, 'u')
 
@@ -288,6 +319,16 @@ const replaceReadmeMcpSection = (content, section) => {
   const sectionPattern = new RegExp(`${escapedHeader}[\\s\\S]*?(?=\\n##\\s|$)`, 'u')
 
   if (!sectionPattern.test(content)) {
+    const escapedLegacyHeader = LEGACY_README_MCP_SECTION_HEADER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+    const escapedMarker = README_MCP_MARKER.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+    const legacySectionPattern = new RegExp(`(^|\\n)${escapedLegacyHeader}\\n[\\s\\S]*?${escapedMarker}[\\s\\S]*?(?=\\n##\\s|$)`, 'u')
+
+    if (legacySectionPattern.test(content)) {
+      return content
+        .replace(legacySectionPattern, (match, prefix) => `${prefix}${section.trimEnd()}`)
+        .replace(/\s+$/u, '') + DEFAULT_NEWLINE
+    }
+
     return appendSection(content, section)
   }
 

package/docs/targets/customer-card-communications-after.yml

@@ -33,6 +33,18 @@ target_config:
     - "customer"
   action_scopes: []
 
+context_resources:
+  - id: "customer/card"
+    uri: "embed-ui-v1-contexts://contexts/customer%2Fcard"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "customer"
+    uri: "embed-ui-v1-contexts://custom-contexts/customer"
+action_resources: []
+
 use_when:
   - "Place a widget exactly at customer/card:communications.after."
   - "The widget belongs to the customer card and should appear at this location: Right below the short summary, in the communication section."
@@ -45,4 +57,7 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."

package/docs/targets/customer-card-inwork-after.yml

@@ -33,6 +33,18 @@ target_config:
     - "customer"
   action_scopes: []
 
+context_resources:
+  - id: "customer/card"
+    uri: "embed-ui-v1-contexts://contexts/customer%2Fcard"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "customer"
+    uri: "embed-ui-v1-contexts://custom-contexts/customer"
+action_resources: []
+
 use_when:
   - "Place a widget exactly at customer/card:inWork.after."
   - "The widget belongs to the customer card and should appear at this location: At the end of the \"In progress\" block in the client card."
@@ -45,4 +57,7 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."

package/docs/targets/customer-card-inwork-before.yml

@@ -33,6 +33,18 @@ target_config:
     - "customer"
   action_scopes: []
 
+context_resources:
+  - id: "customer/card"
+    uri: "embed-ui-v1-contexts://contexts/customer%2Fcard"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "customer"
+    uri: "embed-ui-v1-contexts://custom-contexts/customer"
+action_resources: []
+
 use_when:
   - "Place a widget exactly at customer/card:inWork.before."
   - "The widget belongs to the customer card and should appear at this location: At the beginning of the \"In Progress\" block in the client card."
@@ -45,4 +57,7 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."

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

@@ -34,6 +34,20 @@ target_config:
     - "customer"
   action_scopes: []
 
+context_resources:
+  - id: "customer/card"
+    uri: "embed-ui-v1-contexts://contexts/customer%2Fcard"
+  - id: "customer/card:phone"
+    uri: "embed-ui-v1-contexts://contexts/customer%2Fcard%3Aphone"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "customer"
+    uri: "embed-ui-v1-contexts://custom-contexts/customer"
+action_resources: []
+
 use_when:
   - "Place a widget exactly at customer/card:phone."
   - "The widget belongs to the customer card and should appear at this location: Right after the phone number in the list."
@@ -46,4 +60,7 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."

package/docs/targets/order-card-comment-manager-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:comment.manager.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input field."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-common-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:common.after."
   - "The widget belongs to the full order form and should appear at this location: Section end, right under the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-common-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:common.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-customer-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:customer.after."
   - "The widget belongs to the full order form and should appear at this location: Section end, right under the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-customer-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:customer.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-customer-email.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:customer.email."
   - "The widget belongs to the full order form and should appear at this location: Right after the input field."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-customer-phone.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:customer.phone."
   - "The widget belongs to the full order form and should appear at this location: Right after the input field."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-delivery-address.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:delivery.address."
   - "The widget belongs to the full order form and should appear at this location: Right under the input field."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-delivery-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:delivery.after."
   - "The widget belongs to the full order form and should appear at this location: Section end, right under the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-delivery-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:delivery.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-dimensions-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:dimensions.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-list-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:list.after."
   - "The widget belongs to the full order form and should appear at this location: Section start, right under the list."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-list-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:list.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-payment-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:payment.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-store-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/card:store.before."
   - "The widget belongs to the full order form and should appear at this location: Section start, right above the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-mg-delivery-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/mg:delivery.after."
   - "The widget belongs to the chat order form and should appear at this location: Section end, right under the input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-mg-delivery-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/mg:delivery.before."
   - "The widget belongs to the chat order form and should appear at this location: Section start, right above the input field."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-mg-list-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/mg:list.after."
   - "The widget belongs to the chat order form and should appear at this location: Section end, right after the list of order items and before the discount, privilege selection, etc. input fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-mg-list-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/mg:list.before."
   - "The widget belongs to the chat order form and should appear at this location: Section start, right above the list of order items."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-mg-payment-after.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/mg:payment.after."
   - "The widget belongs to the chat order form and should appear at this location: Section end, after the list of payments, controls, and custom fields."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-mg-payment-before.yml

@@ -35,6 +35,22 @@ target_config:
   action_scopes:
     - "order/card"
 
+context_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard"
+  - id: "order/card:settings"
+    uri: "embed-ui-v1-contexts://contexts/order%2Fcard%3Asettings"
+  - id: "user/current"
+    uri: "embed-ui-v1-contexts://contexts/user%2Fcurrent"
+  - id: "settings"
+    uri: "embed-ui-v1-contexts://contexts/settings"
+custom_context_resources:
+  - id: "order"
+    uri: "embed-ui-v1-contexts://custom-contexts/order"
+action_resources:
+  - id: "order/card"
+    uri: "embed-ui-v1-contexts://actions/order%2Fcard"
+
 use_when:
   - "Place a widget exactly at order/mg:payment.before."
   - "The widget belongs to the chat order form and should appear at this location: Section start, right above the input field."
@@ -47,5 +63,8 @@ avoid_when:
 ai_notes:
   - "Use the target id as the runner registration key."
   - "Use targets[target].contexts as the source of truth for context availability."
+  - "Read linked context_resources, action_resources, and custom_context_resources before reasoning about fields, mutations, or custom data."
+  - "Do not infer context field shape from the target id, page name, or widget placement."
+  - "For mutation scenarios, check the linked action profile before writing fields directly."
   - "Do not duplicate target context lists in generated widget code."
   - "Order card and chat order form targets share the same order form data contract."

package/package.json

@@ -5,7 +5,7 @@
     "embed-ui-v1-endpoint-mcp": "bin/embed-ui-v1-endpoint-mcp.mjs"
   },
   "type": "module",
-  "version": "0.9.23-alpha.2",
+  "version": "0.9.23",
   "description": "Endpoint API for integrations in RetailCRM",
   "license": "MIT",
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
@@ -100,17 +100,17 @@
   "peerDependencies": {
     "@omnicajs/vue-remote": "^0.2.24",
     "@remote-ui/rpc": "^1.4",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.23-alpha.2",
-    "@retailcrm/embed-ui-v1-types": "^0.9.23-alpha.2",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.23",
+    "@retailcrm/embed-ui-v1-types": "^0.9.23",
     "pinia": "^2.2",
     "vue": "^3.5"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@remote-ui/rpc": "^1.4.7",
-    "@retailcrm/embed-ui-v1-components": "^0.9.23-alpha.2",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.23-alpha.2",
-    "@retailcrm/embed-ui-v1-types": "^0.9.23-alpha.2"
+    "@retailcrm/embed-ui-v1-components": "^0.9.23",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.23",
+    "@retailcrm/embed-ui-v1-types": "^0.9.23"
   },
   "devDependencies": {
     "@retailcrm/image-preview": "^1.0.2",