@retailcrm/embed-ui-v1-endpoint 0.9.22-alpha.4 → 0.9.22-alpha.7

package/README.md

@@ -100,6 +100,14 @@ npx @retailcrm/embed-ui-v1-endpoint init-config
 npx @retailcrm/embed-ui-v1-endpoint init-config --mcp-client-configs cursor,junie,vscode
 ```
 
+Для Codex CLI можно добавить `codex` в список. В этом случае будет создана или
+обновлена запись в `.codex/config.toml`; user-level `codex mcp add` команда не
+запускается автоматически.
+
+Корневой `.mcp.json` рассчитан на Claude Code project scope и использует
+`${CLAUDE_PROJECT_DIR:-.}/node_modules/.bin/embed-ui-v1-endpoint-mcp`. Для Cursor
+и VS Code генерируются client-specific project configs с `${workspaceFolder}`.
+
 С `--force` можно обновить уже существующие управляемые записи. Команда
 обновляет только запись `retailcrm-embed-ui-v1-endpoint`, а остальные серверы и
 пользовательские настройки клиентских конфигов оставляет без изменений.

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

@@ -10,22 +10,36 @@ const AGENTS_SECTION_HEADER = '## @retailcrm/embed-ui-v1-endpoint'
 const 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_SERVER_CONFIG = {
-  command: 'npx',
-  args: ['-y', '-p', PACKAGE_NAME, 'embed-ui-v1-endpoint-mcp'],
-}
+const MCP_BIN_NAME = process.platform === 'win32' ? 'embed-ui-v1-endpoint-mcp.cmd' : 'embed-ui-v1-endpoint-mcp'
+const RELATIVE_MCP_BIN_PATH = `./node_modules/.bin/${MCP_BIN_NAME}`
+const CLAUDE_PROJECT_MCP_BIN_PATH = `\${CLAUDE_PROJECT_DIR:-.}/node_modules/.bin/${MCP_BIN_NAME}`
+const WORKSPACE_MCP_BIN_PATH = `\${workspaceFolder}/node_modules/.bin/${MCP_BIN_NAME}`
 const MCP_CLIENT_CONFIGS = {
+  codex: {
+    type: 'codex-file',
+    filePath: '.codex/config.toml',
+    command: RELATIVE_MCP_BIN_PATH,
+  },
   cursor: {
+    type: 'file',
     filePath: '.cursor/mcp.json',
     rootField: 'mcpServers',
+    command: WORKSPACE_MCP_BIN_PATH,
   },
   junie: {
+    type: 'file',
     filePath: '.junie/mcp/mcp.json',
     rootField: 'mcpServers',
+    command: RELATIVE_MCP_BIN_PATH,
   },
   vscode: {
+    type: 'file',
     filePath: '.vscode/mcp.json',
     rootField: 'servers',
+    command: WORKSPACE_MCP_BIN_PATH,
+    config: {
+      type: 'stdio',
+    },
   },
 }
 
@@ -35,7 +49,7 @@ const HELP_TEXT = `Usage:
 
 Options:
   -f, --force                  Replace existing managed sections and MCP server entries
-      --mcp-client-configs     Comma-separated MCP client configs to create (cursor,junie,vscode)
+      --mcp-client-configs     Comma-separated project-level MCP client configs to create (codex,cursor,junie,vscode)
       --dry-run                Print planned config changes without writing files
   -h, --help                   Show this help
 
@@ -44,9 +58,20 @@ Examples:
   npx ${PACKAGE_NAME} init-agents ./my-project
   npx ${PACKAGE_NAME} init-agents --force
   npx ${PACKAGE_NAME} init-config ./my-project
-  npx ${PACKAGE_NAME} init-config ./my-project --mcp-client-configs cursor,junie,vscode
+  npx ${PACKAGE_NAME} init-config ./my-project --mcp-client-configs codex,cursor,junie,vscode
 `
 
+const resolveLocalMcpBinPath = (target) => path.join(target, 'node_modules', '.bin', MCP_BIN_NAME)
+
+const createMcpServerConfig = (command, config = {}) => ({
+  ...config,
+  command,
+})
+
+const printMcpNotice = (message) => {
+  console.log(`MCP: ${message}`)
+}
+
 const parseArgs = (argv) => {
   const options = {
     command: null,
@@ -128,15 +153,15 @@ When working with \`${PACKAGE_NAME}\` in this project:
 5. When the task involves widget targets, target placement, target contexts, target metadata, or choosing a target, use the package MCP server if it is available.
 6. First read \`embed-ui-v1-endpoint://targets\` to discover available target profiles.
 7. Then read the relevant \`embed-ui-v1-endpoint://targets/<encoded-target>\` resource before answering or changing code related to that target.
-8. If MCP resources are not available, use the generated YAML profiles from \`./node_modules/${PACKAGE_NAME}/docs/targets/*.yml\` as the fallback source.
-9. Prefer target profiles over guessing target placement, contexts, or semantic intent from names alone.
+8. A project \`.mcp.json\` may require restarting or reconnecting the AI client before MCP resources appear in the current session.
+9. If MCP resources are not available, use the generated YAML profiles from \`./node_modules/${PACKAGE_NAME}/docs/targets/*.yml\` as the fallback source.
+10. Prefer target profiles over guessing target placement, contexts, or semantic intent from names alone.
 
 Suggested MCP stdio server configuration:
 
 \`\`\`json
 {
-  "command": "npx",
-  "args": ["-y", "-p", "${PACKAGE_NAME}", "embed-ui-v1-endpoint-mcp"]
+  "command": "${CLAUDE_PROJECT_MCP_BIN_PATH}"
 }
 \`\`\`
 `
@@ -145,17 +170,19 @@ Suggested MCP stdio server configuration:
 const createMcpReadmeSection = (clientConfigs) => {
   const clientConfigText = clientConfigs.length
     ? `Client MCP configs were also requested: ${clientConfigs.map((clientConfig) => `\`${clientConfig}\``).join(', ')}. Review the generated files and restart the AI client if it is already open.`
-    : 'Client MCP configs are not created by default. For supported project-level configs, rerun init with `--mcp-client-configs cursor,junie,vscode`.'
+    : 'Client MCP configs are not created by default. For supported project-level configs, rerun init with `--mcp-client-configs codex,cursor,junie,vscode`.'
 
   return `${README_MCP_SECTION_HEADER}
 
 The project has an MCP server configuration for \`${PACKAGE_NAME}\`.
 It exposes AI-friendly widget target descriptions as MCP resources.
+If the AI client was already running, restart or reconnect it before expecting these resources
+to appear in that session.
 
 Basic check:
 
 \`\`\`bash
-npx -p ${PACKAGE_NAME} embed-ui-v1-endpoint-mcp
+./node_modules/.bin/embed-ui-v1-endpoint-mcp
 \`\`\`
 
 Primary resources:
@@ -165,10 +192,46 @@ Primary resources:
 
 ${clientConfigText}
 
+The root \`.mcp.json\` is compatible with Claude Code project scope and uses
+\`${CLAUDE_PROJECT_MCP_BIN_PATH}\` so the server is resolved from the project directory.
+Cursor and VS Code project configs use \`${WORKSPACE_MCP_BIN_PATH}\`. Codex and Junie use
+\`${RELATIVE_MCP_BIN_PATH}\`.
+
+### Codex CLI
+
+Codex supports project-scoped MCP config in \`.codex/config.toml\` for trusted projects.
+Create it with:
+
+\`\`\`bash
+npx ${PACKAGE_NAME} init-config --mcp-client-configs codex
+codex mcp list
+\`\`\`
+
+If the server does not appear, trust the project in Codex and restart the session. The
+project-level config keeps this repository pinned to its own local
+\`./node_modules/.bin/embed-ui-v1-endpoint-mcp\` binary.
+
 ### User-Level MCP Clients
 
 Some clients store MCP servers in a user-level config outside this repository. Init does not edit
-those files. Add the same server manually and restart the client.
+those files. Add the same server manually and restart the client. Use this only when this machine
+works with one Embed UI project/version, because multiple user-level servers from different
+projects can expose the same resource URIs and confuse the AI client.
+
+Codex CLI user-level setup:
+
+\`\`\`bash
+codex mcp add ${MCP_SERVER_NAME} -- "$(realpath ./node_modules/.bin/embed-ui-v1-endpoint-mcp)"
+codex mcp list
+codex mcp get ${MCP_SERVER_NAME}
+\`\`\`
+
+Equivalent \`~/.codex/config.toml\` block:
+
+\`\`\`toml
+[mcp_servers.${MCP_SERVER_NAME}]
+command = "/absolute/path/to/project/node_modules/.bin/embed-ui-v1-endpoint-mcp"
+\`\`\`
 
 Claude Desktop config paths:
 
@@ -181,8 +244,7 @@ Config snippet:
 {
   "mcpServers": {
     "${MCP_SERVER_NAME}": {
-      "command": "npx",
-      "args": ["-y", "-p", "${PACKAGE_NAME}", "embed-ui-v1-endpoint-mcp"]
+      "command": "/absolute/path/to/project/node_modules/.bin/embed-ui-v1-endpoint-mcp"
     }
   }
 }
@@ -271,6 +333,44 @@ const writeJson = (filePath, value, dryRun) => {
   fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}${DEFAULT_NEWLINE}`, 'utf8')
 }
 
+const createCodexMcpTomlSection = (serverConfig) => {
+  return `[mcp_servers.${MCP_SERVER_NAME}]
+command = "${serverConfig.command.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"
+`
+}
+
+const writeCodexMcpServerConfig = (target, options, serverConfig) => {
+  const relativePath = MCP_CLIENT_CONFIGS.codex.filePath
+  const filePath = path.join(target, relativePath)
+  const fileExists = fs.existsSync(filePath)
+  const currentContent = fileExists ? fs.readFileSync(filePath, 'utf8') : ''
+  const section = createCodexMcpTomlSection(serverConfig)
+  const escapedServerName = MCP_SERVER_NAME.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  const sectionPattern = new RegExp(`(^|\\n)\\[mcp_servers\\.${escapedServerName}\\][\\s\\S]*?(?=\\n\\[|$)`, 'u')
+  const hasServerSection = sectionPattern.test(currentContent)
+
+  if (hasServerSection && !options.force) {
+    console.log(`${relativePath} already contains ${MCP_SERVER_NAME}`)
+    console.log('Nothing was changed. Re-run with --force to refresh that server entry.')
+    return false
+  }
+
+  const nextContent = hasServerSection
+    ? currentContent
+      .replace(sectionPattern, (match, prefix) => `${prefix}${section.trimEnd()}`)
+      .replace(/\s+$/u, '') + DEFAULT_NEWLINE
+    : appendSection(currentContent, section)
+
+  if (!options.dryRun) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true })
+    fs.writeFileSync(filePath, nextContent, 'utf8')
+  }
+
+  const action = fileExists ? 'updated' : 'created'
+  console.log(`${relativePath} ${options.dryRun ? `would be ${action}` : `was ${action}`}`)
+  return true
+}
+
 const initAgents = (target, force) => {
   if (!fs.existsSync(target)) {
     throw new Error(`Target path does not exist: ${target}`)
@@ -314,7 +414,7 @@ const initAgents = (target, force) => {
   console.log(`The ${PACKAGE_NAME} instructions were appended to the end of the file.`)
 }
 
-const writeMcpServerConfig = (target, relativePath, rootField, options) => {
+const writeMcpServerConfig = (target, relativePath, rootField, options, serverConfig) => {
   const filePath = path.join(target, relativePath)
   const fileExists = fs.existsSync(filePath)
   const config = readJsonObject(filePath)
@@ -323,14 +423,22 @@ const writeMcpServerConfig = (target, relativePath, rootField, options) => {
   if (servers[MCP_SERVER_NAME] && !options.force) {
     console.log(`${relativePath} already contains ${MCP_SERVER_NAME}`)
     console.log('Nothing was changed. Re-run with --force to refresh that server entry.')
-    return
+    return false
   }
 
-  servers[MCP_SERVER_NAME] = MCP_SERVER_CONFIG
+  servers[MCP_SERVER_NAME] = serverConfig
   writeJson(filePath, config, options.dryRun)
 
   const action = fileExists ? 'updated' : 'created'
   console.log(`${relativePath} ${options.dryRun ? `would be ${action}` : `was ${action}`}`)
+  return true
+}
+
+const printFileClientMcpNotice = (clientConfig, target, serverConfig) => {
+  const config = MCP_CLIENT_CONFIGS[clientConfig]
+
+  printMcpNotice(`${clientConfig} MCP config points to local binary ${serverConfig.command}. Restart or reconnect the client to use new resources.`)
+  printMcpNotice(`${clientConfig} config file: ${path.join(target, config.filePath)}`)
 }
 
 const resolveMcpClientConfigs = (tokens) => {
@@ -379,12 +487,30 @@ const initConfig = (target, options) => {
   }
 
   const clientConfigs = resolveMcpClientConfigs(options.mcpClientConfigs)
+  const serverConfig = createMcpServerConfig(CLAUDE_PROJECT_MCP_BIN_PATH)
+  const absoluteMcpBinPath = resolveLocalMcpBinPath(target)
 
-  writeMcpServerConfig(target, '.mcp.json', 'mcpServers', options)
+  writeMcpServerConfig(target, '.mcp.json', 'mcpServers', options, serverConfig)
+  printMcpNotice(`Project MCP config points to local binary ${serverConfig.command}. Restart or reconnect MCP clients to use new resources.`)
+  if (!fs.existsSync(absoluteMcpBinPath)) {
+    printMcpNotice(`Local MCP binary is not available yet. Install project dependencies before starting MCP clients: ${absoluteMcpBinPath}`)
+  }
 
   for (const clientConfig of clientConfigs) {
     const config = MCP_CLIENT_CONFIGS[clientConfig]
-    writeMcpServerConfig(target, config.filePath, config.rootField, options)
+
+    if (config.type === 'codex-file') {
+      const codexServerConfig = createMcpServerConfig(config.command)
+
+      writeCodexMcpServerConfig(target, options, codexServerConfig)
+      printMcpNotice(`codex project config points to local binary ${codexServerConfig.command}. Trust the project and restart Codex to use new resources.`)
+      continue
+    }
+
+    const clientServerConfig = createMcpServerConfig(config.command, config.config)
+
+    writeMcpServerConfig(target, config.filePath, config.rootField, options, clientServerConfig)
+    printFileClientMcpNotice(clientConfig, target, clientServerConfig)
   }
 
   updateMcpReadmeNotes(target, clientConfigs, options)

package/dist/mcp/server.cjs

@@ -67,6 +67,18 @@ const createEndpointMcpServer = () => {
     name: "@retailcrm/embed-ui-v1-endpoint",
     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();
   const targets = readTargetProfiles();
   server.registerResource("v1-endpoint targets index", "embed-ui-v1-endpoint://targets", {
     title: "v1-endpoint widget targets index",

package/dist/mcp/server.js

@@ -47,6 +47,18 @@ const createEndpointMcpServer = () => {
     name: "@retailcrm/embed-ui-v1-endpoint",
     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();
   const targets = readTargetProfiles();
   server.registerResource("v1-endpoint targets index", "embed-ui-v1-endpoint://targets", {
     title: "v1-endpoint widget targets index",

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@retailcrm/embed-ui-v1-endpoint",
   "bin": {
-    "embed-ui-v1-endpoint": "./bin/embed-ui-v1-endpoint.mjs",
-    "embed-ui-v1-endpoint-mcp": "./bin/embed-ui-v1-endpoint-mcp.mjs"
+    "embed-ui-v1-endpoint": "bin/embed-ui-v1-endpoint.mjs",
+    "embed-ui-v1-endpoint-mcp": "bin/embed-ui-v1-endpoint-mcp.mjs"
   },
   "type": "module",
-  "version": "0.9.22-alpha.4",
+  "version": "0.9.22-alpha.7",
   "description": "Endpoint API for integrations in RetailCRM",
   "license": "MIT",
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
-  "repository": "git@github.com:retailcrm/embed-ui.git",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/retailcrm/embed-ui.git"
+  },
   "exports": {
     ".": {
       "types": "./dist/remote.d.ts",
@@ -97,17 +100,17 @@
   "peerDependencies": {
     "@omnicajs/vue-remote": "^0.2.23",
     "@remote-ui/rpc": "^1.4",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.4",
-    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.4",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.7",
+    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.7",
     "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.22-alpha.4",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.4",
-    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.4"
+    "@retailcrm/embed-ui-v1-components": "^0.9.22-alpha.7",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.22-alpha.7",
+    "@retailcrm/embed-ui-v1-types": "^0.9.22-alpha.7"
   },
   "devDependencies": {
     "@retailcrm/image-preview": "^1.0.2",