@besales/mcp 0.48.0 → 1.0.0-beta.4

package/scripts/build-onprem.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+// Выполняет поставщик на целевой ОС/архитектуре, после immutable install.
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  renameSync,
+  rmSync,
+  writeFileSync,
+} from 'node:fs';
+import { resolve, join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+const [rawBase, output] = process.argv.slice(2);
+if (!rawBase || !output) throw new Error('Customer API URL and new output directory required');
+const base = new URL(rawBase);
+if (
+  base.protocol !== 'https:' ||
+  base.username ||
+  base.password ||
+  base.search ||
+  base.hash ||
+  base.pathname.replace(/\/+$/u, '') !== '/api/v2'
+)
+  throw new Error(
+    'Usage: node scripts/build-onprem.mjs https://customer.example/api/v2 NEW_OUTPUT_DIRECTORY',
+  );
+base.pathname = '/api/v2';
+const destination = resolve(output);
+if (existsSync(destination)) throw new Error('Output directory already exists');
+execFileSync('yarn', ['build'], { stdio: 'inherit' });
+mkdirSync(destination, { recursive: true, mode: 0o700 });
+cpSync('dist', join(destination, 'dist'), { recursive: true });
+mkdirSync(join(destination, 'bin'));
+cpSync('bin/besales-onprem.mjs', join(destination, 'bin/besales-onprem.mjs'));
+cpSync('README.onprem.ru.md', join(destination, 'README.onprem.ru.md'));
+const sourcePackage = JSON.parse(readFileSync('package.json', 'utf8'));
+writeFileSync(
+  join(destination, 'package.json'),
+  JSON.stringify(
+    {
+      name: sourcePackage.name,
+      version: sourcePackage.version,
+      type: 'module',
+      bin: { 'besales-mcp': './bin/besales-onprem.mjs' },
+    },
+    null,
+    2,
+  ),
+);
+writeFileSync(
+  join(destination, 'onprem.json'),
+  JSON.stringify(
+    { apiBaseUrl: base.href, oauthAuthorizeUrl: `${base.href}/auth/mcp-connect/start` },
+    null,
+    2,
+  ),
+  { mode: 0o600 },
+);
+// Только runtime dependencies. Список берётся из установленного графа Yarn, без второго сетевого install.
+execFileSync('yarn', ['workspaces', 'focus', '--production'], {
+  cwd: process.cwd(),
+  stdio: 'inherit',
+});
+cpSync('node_modules', join(destination, 'node_modules'), { recursive: true });
+function clean(dir) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const file = join(dir, entry.name);
+    if (
+      /\.(?:[cm]?ts|tsx|map|c|cc|cpp|h|hpp)$/iu.test(entry.name) ||
+      ['test', 'tests', '__tests__', '.cache', '.yarn-state.yml'].includes(entry.name)
+    )
+      rmSync(file, { recursive: true, force: true });
+    else if (entry.isDirectory()) {
+      if (entry.name === 'src') {
+        const runtime = join(dir, 'onprem_runtime');
+        renameSync(file, runtime);
+        clean(runtime);
+      } else clean(file);
+    }
+  }
+}
+function rewrite(dir) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const file = join(dir, entry.name);
+    if (entry.isDirectory()) rewrite(file);
+    else if (entry.isFile() && /\.(?:[cm]?js|json)$/u.test(entry.name)) {
+      const text = readFileSync(file, 'utf8')
+        .replace(/^\s*\/\/[#@]\s*sourceMappingURL=.*$/gmu, '')
+        .replace(/\/\*[#@]\s*sourceMappingURL=[^*]*\*\//gu, '');
+      writeFileSync(
+        file,
+        text
+          .replace(/(^|[./])src(?=\/|["'`]|$)/gmu, '$1onprem_runtime')
+          .replace(/(["'`])src\//gu, '$1onprem_runtime/'),
+      );
+    }
+  }
+}
+clean(destination);
+rewrite(destination);
+execFileSync(process.execPath, [join(destination, 'bin/besales-onprem.mjs'), '--help'], {
+  stdio: 'inherit',
+});
+console.log(
+  `On-prem MCP ready: ${process.platform}/${process.arch}; archive the output directory (no build tools or source files).`,
+);

package/scripts/connect-clients.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# Запускай своим пользователем: секреты идут только в настройки клиентов и закрытый файл.
+set -euo pipefail
+
+parse_connections() {
+  # Данные читаются только из stdin: ни имя, ни UUID не становятся кодом или опцией Node.
+  node -e '
+    const MAX_NAME_LENGTH = 200;
+    const MAX_SLUG_LENGTH = 64;
+    const UUID_PREFIX_LENGTH = 8;
+    const letters = {а:"a",б:"b",в:"v",г:"g",д:"d",е:"e",ё:"e",ж:"zh",з:"z",и:"i",й:"y",к:"k",л:"l",м:"m",н:"n",о:"o",п:"p",р:"r",с:"s",т:"t",у:"u",ф:"f",х:"h",ц:"ts",ч:"ch",ш:"sh",щ:"sch",ъ:"",ы:"y",ь:"",э:"e",ю:"yu",я:"ya"};
+    try {
+      const connections = JSON.parse(require("node:fs").readFileSync(0, "utf8"));
+      if (!Array.isArray(connections)) throw new Error();
+      const seen = new Set();
+      const lines = connections.map(connection => {
+        const id = connection?.workspaceId;
+        const name = connection?.workspaceName;
+        if (typeof id !== "string" || !/^[0-9a-f-]{36}$/.test(id) || seen.has(id) ||
+            (name != null && typeof name !== "string")) throw new Error();
+        seen.add(id);
+        const clean = (name ?? "").replace(/[\u0000-\u001f\u007f]/g, " ").slice(0, MAX_NAME_LENGTH);
+        const slug = [...clean.toLowerCase()].map(c => letters[c] ?? c).join("")
+          .normalize("NFKD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-")
+          .slice(0, MAX_SLUG_LENGTH).replace(/^-|-$/g, "") || id.slice(0, UUID_PREFIX_LENGTH);
+        return id + "\tbesales-" + slug;
+      });
+      if (lines.length) process.stdout.write(lines.join("\n") + "\n");
+    } catch { process.exitCode = 1; }
+  ' --
+}
+
+main() (
+  local url=${BESALES_MCP_URL:-https://mcp.besales.ai/mcp}
+  local bridge_text=${BESALES_MCP_BRIDGE:-npx -y @besales/mcp@beta}
+  local bridge=()
+  # Это список аргументов, разделённых пробелами, без исполнения shell-кода.
+  read -r -a bridge <<< "$bridge_text"
+  local have_claude=false have_codex=false
+  if command -v claude >/dev/null 2>&1; then have_claude=true
+  else printf '%s\n' 'Claude Code отсутствует в PATH: пропускаю этот клиент.'; fi
+  if command -v codex >/dev/null 2>&1; then have_codex=true
+  else printf '%s\n' 'Codex CLI отсутствует в PATH: пропускаю этот клиент.'; fi
+  if [[ $have_claude == false && $have_codex == false ]]; then return 0; fi
+
+  local connections parsed id base entry key var selected arg index other count
+  connections=$("${bridge[@]}" connections --json 2>/dev/null) || {
+    printf '%s\n' 'Не удалось прочитать подключения. Выполни connect и повтори запуск.' >&2; return 1;
+  }
+  parsed=$(printf '%s' "$connections" | parse_connections) || {
+    printf '%s\n' 'Неверный JSON подключений. Обнови мост и повтори запуск.' >&2; return 1;
+  }
+  local ids=() bases=() entries=() matched=()
+  while IFS=$'\t' read -r id base; do
+    [[ -n $id ]] || continue
+    ids+=("$id"); bases+=("$base")
+  done <<< "$parsed"
+  count=${#ids[@]}
+  if [[ $count -eq 0 ]]; then printf '%s\n' 'Нет подключённых областей. Сначала выполни connect.'; return 0; fi
+  for ((index=0; index<count; index++)); do
+    base=${bases[$index]}; entry=$base
+    for ((other=0; other<count; other++)); do
+      if [[ $other -ne $index && ${bases[$other]} == "$base" ]]; then entry="$base-${ids[$index]:0:4}"; break; fi
+    done
+    entries+=("$entry")
+  done
+  # Редкое совпадение четырёх символов UUID тоже не должно перезаписать чужое подключение.
+  for ((index=0; index<count; index++)); do
+    for ((other=0; other<count; other++)); do
+      if [[ $other -ne $index && ${entries[$other]} == "${entries[$index]}" ]]; then
+        entries[$index]="${bases[$index]}-${ids[$index]}"
+        entries[$other]="${bases[$other]}-${ids[$other]}"
+      fi
+    done
+  done
+  for arg in "$@"; do matched+=(false); done
+
+  umask 077
+  local secrets_dir="$HOME/.besales-secrets" keys_file="$HOME/.besales-secrets/mcp-remote-keys.env"
+  mkdir -p "$secrets_dir"
+  chmod 700 "$secrets_dir"
+  local temporary
+  temporary=$(mktemp "$secrets_dir/.mcp-keys.XXXXXX")
+  # EXIT сохраняет прежний файл, если настройка клиента завершилась ошибкой.
+  trap 'rm -f -- "$temporary" "$temporary.next"' EXIT
+  local header='# Ключи онлайн-MCP Besales для Codex CLI.'
+  if [[ -f $keys_file ]]; then
+    # Сохраняем посторонние строки при полном и выборочном запуске, не исполняя файл.
+    awk -v header="$header" '{ print; if ($0 == header) found=1 } END { if (!found) print header }' "$keys_file" > "$temporary"
+  else printf '%s\n' "$header" > "$temporary"; fi
+
+  local connected=0 arg_index
+  for ((index=0; index<count; index++)); do
+    entry=${entries[$index]}; id=${ids[$index]}; selected=false; arg_index=0
+    if [[ $# -eq 0 ]]; then selected=true; fi
+    for arg in "$@"; do
+      if [[ $entry == "$arg" || $id == "$arg"* ]]; then selected=true; matched[$arg_index]=true; fi
+      arg_index=$((arg_index + 1))
+    done
+    [[ $selected == true ]] || continue
+    key=$("${bridge[@]}" key "$id" 2>/dev/null) || {
+      printf '[%s] пропуск: ключ не получен, повтори connect.\n' "$entry"; continue;
+    }
+    if [[ ! $key =~ ^mcp_[A-Za-z0-9_-]+$ ]]; then
+      printf '[%s] пропуск: неверный формат ключа, повтори connect.\n' "$entry"; continue
+    fi
+    var="BESALES_MCP_KEY_$(printf '%s' "$entry" | tr 'a-z-' 'A-Z_')"
+    if [[ $have_claude == true ]]; then
+      claude mcp remove --scope user "$entry" >/dev/null 2>&1 || true
+      claude mcp add --scope user --transport http "$entry" "$url" --header "Authorization: Bearer $key" >/dev/null 2>&1 || {
+        printf '[%s] ошибка настройки Claude Code.\n' "$entry" >&2; return 1;
+      }
+      printf '[%s] Claude Code подключён.\n' "$entry"
+    fi
+    if [[ $have_codex == true ]]; then
+      codex mcp remove "$entry" >/dev/null 2>&1 || true
+      codex mcp add "$entry" --url "$url" --bearer-token-env-var "$var" >/dev/null 2>&1 || {
+        printf '[%s] ошибка настройки Codex CLI.\n' "$entry" >&2; return 1;
+      }
+      printf '[%s] Codex CLI подключён.\n' "$entry"
+    fi
+    awk -v variable="$var" '$0 !~ "^export " variable "="' "$temporary" > "$temporary.next"
+    mv "$temporary.next" "$temporary"
+    printf 'export %s="%s"\n' "$var" "$key" >> "$temporary"
+    key=''; connected=$((connected + 1))
+  done
+  arg_index=0
+  for arg in "$@"; do
+    if [[ ${matched[$arg_index]} == false ]]; then printf 'Не найдено подключение: %s\n' "$arg" >&2; fi
+    arg_index=$((arg_index + 1))
+  done
+  chmod 600 "$temporary"
+  mv "$temporary" "$keys_file"
+  trap - EXIT
+  printf 'Подключено областей: %s\n' "$connected"
+  printf 'Для Codex добавь в ~/.zshrc (или ~/.bashrc) строку: source %q\n' "$keys_file"
+  printf '%s\n' 'Затем выполни source в текущем терминале и запускай Codex из него.'
+  printf '%s\n' 'Проверка: claude mcp list   |   codex mcp list'
+)
+
+if [[ ${BASH_SOURCE[0]} == "$0" ]]; then main "$@"; fi

package/scripts/connect-scopes.mjs

@@ -0,0 +1,166 @@
+// Права, которые отгруженный клиент реально запрашивает при подключении: значение, уходящее в параметр `scope`
+// адреса страницы согласия.
+//
+// ⛔ Извлекается РАЗБОРОМ СИНТАКСИЧЕСКОГО ДЕРЕВА, а не поиском текста. Сервер обязан принять каждое право, которое
+// отгруженный клиент шлёт, — иначе подключение ломается у всех, кто обновил пакет. Поиск строки по шаблону молча
+// пропустил бы новую форму объявления (спред, импорт, вычисление) и отдал бы серверу устаревший набор. Поэтому
+// поддержаны ровно формы, встречавшиеся в пакете, а любая другая — отказ выгрузки с названием формы.
+import ts from 'typescript';
+
+/**
+ * @param {string} source текст `src/auth/oauth-client.ts`
+ * @returns {string[]} права в порядке объявления
+ */
+export function extractConnectScopes(source) {
+  const file = ts.createSourceFile('oauth-client.ts', source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+  const scopeArgument = singleScopeArgument(file);
+  const scopes = resolveScopes(file, scopeArgument, new Set());
+  if (scopes.length === 0) {
+    throw new Error('Набор прав подключения пуст: выгрузка без прав сделала бы проверку сервера пустой');
+  }
+  const duplicates = scopes.filter((scope, index) => scopes.indexOf(scope) !== index);
+  if (duplicates.length > 0) {
+    throw new Error(`Право подключения объявлено дважды: ${duplicates.join(', ')}`);
+  }
+  return scopes;
+}
+
+/** Ровно один вызов `<что-то>.set('scope', X)`: второй сделал бы выбор неоднозначным. */
+function singleScopeArgument(file) {
+  const found = [];
+  const visit = (node) => {
+    if (
+      ts.isCallExpression(node) &&
+      ts.isPropertyAccessExpression(node.expression) &&
+      node.expression.name.text === 'set' &&
+      node.arguments.length === 2 &&
+      ts.isStringLiteralLike(node.arguments[0]) &&
+      node.arguments[0].text === 'scope'
+    ) {
+      found.push(node.arguments[1]);
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(file);
+  if (found.length !== 1) {
+    throw new Error(`Ожидался ровно один вызов set('scope', …), найдено ${found.length}`);
+  }
+  return found[0];
+}
+
+function resolveScopes(file, expression, seen) {
+  const node = unwrap(expression);
+  if (ts.isStringLiteralLike(node)) {
+    return node.text.split(' ').filter((token) => token !== '');
+  }
+  if (ts.isIdentifier(node)) {
+    return resolveScopes(file, initializerOf(file, node.text, seen), seen);
+  }
+  if (
+    ts.isCallExpression(node) &&
+    ts.isPropertyAccessExpression(node.expression) &&
+    node.expression.name.text === 'join' &&
+    node.arguments.length === 1 &&
+    ts.isStringLiteralLike(node.arguments[0]) &&
+    node.arguments[0].text === ' '
+  ) {
+    return resolveList(file, node.expression.expression, seen);
+  }
+  throw new Error(`Неподдержанная форма значения права подключения: ${ts.SyntaxKind[node.kind]}`);
+}
+
+function resolveList(file, expression, seen) {
+  const node = unwrap(expression);
+  if (ts.isIdentifier(node)) {
+    return resolveList(file, initializerOf(file, node.text, seen), seen);
+  }
+  if (!ts.isArrayLiteralExpression(node)) {
+    throw new Error(`Неподдержанная форма списка прав подключения: ${ts.SyntaxKind[node.kind]}`);
+  }
+  return node.elements.map((element) => {
+    if (!ts.isStringLiteralLike(element)) {
+      throw new Error(`Элемент списка прав подключения не строка: ${ts.SyntaxKind[element.kind]}`);
+    }
+    return element.text;
+  });
+}
+
+/** Приведения типа (`as const`, `as T`, `satisfies T`) и скобки на значение не влияют. */
+function unwrap(node) {
+  let current = node;
+  while (ts.isAsExpression(current) || ts.isSatisfiesExpression(current) || ts.isParenthesizedExpression(current)) {
+    current = current.expression;
+  }
+  return current;
+}
+
+/**
+ * Инициализатор переменной верхнего уровня файла; импорт или отсутствие объявления — отказ.
+ *
+ * ⛔ Значение инициализатора — это значение, уходящее в `scope`, только когда имя нельзя изменить и нельзя
+ * заслонить: `let` с переприсваиванием или локальное объявление того же имени внутри функции отдали бы выгрузке
+ * устаревший набор молча. Поэтому требуется `const`, а второе объявление имени где угодно в файле и любое
+ * присваивание ему — отказ.
+ */
+function initializerOf(file, name, seen) {
+  if (seen.has(name)) throw new Error(`Циклическое объявление права подключения: ${name}`);
+  seen.add(name);
+  for (const statement of file.statements) {
+    if (!ts.isVariableStatement(statement)) continue;
+    for (const declaration of statement.declarationList.declarations) {
+      if (ts.isIdentifier(declaration.name) && declaration.name.text === name) {
+        if ((statement.declarationList.flags & ts.NodeFlags.Const) === 0) {
+          throw new Error(`Объявление ${name} не const: значение может быть переприсвоено`);
+        }
+        if (declaration.initializer === undefined) {
+          throw new Error(`У объявления ${name} нет значения`);
+        }
+        assertSingleBinding(file, name);
+        return declaration.initializer;
+      }
+    }
+  }
+  throw new Error(`Объявление ${name} не найдено в файле (импорт не разбирается)`);
+}
+
+/** Ровно одно объявление имени во всём файле и ни одного присваивания ему. */
+function assertSingleBinding(file, name) {
+  let declarations = 0;
+  let assignments = 0;
+  const visit = (node) => {
+    if (ts.isIdentifier(node) && node.text === name && isDeclarationName(node.parent, node)) {
+      declarations += 1;
+    }
+    if (
+      ts.isBinaryExpression(node) &&
+      node.operatorToken.kind >= ts.SyntaxKind.FirstAssignment &&
+      node.operatorToken.kind <= ts.SyntaxKind.LastAssignment
+    ) {
+      // Цель присваивания бывает обёрнута: `(NAME as string) = …`.
+      const target = unwrap(node.left);
+      if (ts.isIdentifier(target) && target.text === name) assignments += 1;
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(file);
+  if (declarations !== 1) {
+    throw new Error(`Имя ${name} объявлено в файле ${declarations} раз: затенение не разбирается`);
+  }
+  if (assignments > 0) {
+    throw new Error(`Имени ${name} присваивается значение: разбор видит только инициализатор`);
+  }
+}
+
+function isDeclarationName(parent, node) {
+  return (
+    ((ts.isVariableDeclaration(parent) ||
+      ts.isParameter(parent) ||
+      ts.isBindingElement(parent) ||
+      ts.isFunctionDeclaration(parent) ||
+      ts.isClassDeclaration(parent) ||
+      ts.isImportSpecifier(parent) ||
+      ts.isImportClause(parent) ||
+      ts.isNamespaceImport(parent)) &&
+      parent.name === node)
+  );
+}

package/scripts/connect-scopes.spec.mjs

@@ -0,0 +1,83 @@
+import { describe, expect, it } from 'vitest';
+
+import { extractConnectScopes } from './connect-scopes.mjs';
+
+describe('extractConnectScopes — права, реально уходящие в параметр scope', () => {
+  it('форма отгруженного пакета: список as const → join → приведение типа → set', () => {
+    const source = `
+      export const MCP_OAUTH_SCOPES = ['mcp:*', 'mcp:platform-setup', 'mcp:funnel-test', 'read:campaigns',
+        'launch:campaigns', 'read:contacts', 'write:operators'] as const;
+      export const OAUTH_SCOPE: ContractConnectScope = MCP_OAUTH_SCOPES.join(' ') as JoinWithSpace<typeof MCP_OAUTH_SCOPES>;
+      function start(url: URL) { url.searchParams.set('scope', OAUTH_SCOPE); }
+    `;
+    expect(extractConnectScopes(source)).toEqual([
+      'mcp:*',
+      'mcp:platform-setup',
+      'mcp:funnel-test',
+      'read:campaigns',
+      'launch:campaigns',
+      'read:contacts',
+      'write:operators',
+    ]);
+  });
+
+  it('форма ветки v2: строка через пробел', () => {
+    const source = `
+      export const OAUTH_SCOPE = 'mcp:* mcp:platform-setup read:contacts';
+      function start(url: URL) { url.searchParams.set('scope', OAUTH_SCOPE); }
+    `;
+    expect(extractConnectScopes(source)).toEqual(['mcp:*', 'mcp:platform-setup', 'read:contacts']);
+  });
+
+  it.each([
+    ['спред', `const BASE = ['mcp:*']; const ALL = [...BASE, 'read:contacts'] as const; const S = ALL.join(' '); function f(u: URL) { u.searchParams.set('scope', S); }`],
+    ['импорт', `import { OAUTH_SCOPE } from './scopes'; function f(u: URL) { u.searchParams.set('scope', OAUTH_SCOPE); }`],
+    ['вычисление', `const S = ['mcp:*'].map((s) => s).join(' '); function f(u: URL) { u.searchParams.set('scope', S); }`],
+    ['шаблонная строка с подстановкой', 'const X = "read:contacts"; const S = `mcp:* ${X}`; function f(u: URL) { u.searchParams.set("scope", S); }'],
+  ])('⛔ незнакомая форма объявления — отказ выгрузки (%s), а не молча устаревший набор', (_label, source) => {
+    expect(() => extractConnectScopes(source)).toThrow();
+  });
+
+  it('⛔ изменяемое объявление с переприсваиванием — отказ, а не значение инициализатора', () => {
+    const source = `
+      export let OAUTH_SCOPE = 'mcp:*';
+      OAUTH_SCOPE = 'mcp:* read:contacts';
+      function start(url: URL) { url.searchParams.set('scope', OAUTH_SCOPE); }
+    `;
+    expect(() => extractConnectScopes(source)).toThrow(/не const/);
+    expect(() =>
+      extractConnectScopes(`
+        export const OAUTH_SCOPE = 'mcp:*';
+        function start(url: URL) { (OAUTH_SCOPE as string) = 'x'; url.searchParams.set('scope', OAUTH_SCOPE); }
+      `),
+    ).toThrow(/присваивается/);
+  });
+
+  it('⛔ локальное объявление того же имени заслоняет верхнее — отказ', () => {
+    const source = `
+      export const OAUTH_SCOPE = 'mcp:*';
+      function start(url: URL) {
+        const OAUTH_SCOPE = 'mcp:* read:contacts';
+        url.searchParams.set('scope', OAUTH_SCOPE);
+      }
+    `;
+    expect(() => extractConnectScopes(source)).toThrow(/объявлено в файле 2 раз/);
+  });
+
+  it('⛔ два вызова set(scope) — отказ: выбор неоднозначен', () => {
+    const source = `
+      const A = 'mcp:*'; const B = 'mcp:* read:contacts';
+      function f(u: URL) { u.searchParams.set('scope', A); u.searchParams.set('scope', B); }
+    `;
+    expect(() => extractConnectScopes(source)).toThrow(/ровно один/);
+  });
+
+  it('⛔ пустой набор и дубли — отказ', () => {
+    expect(() =>
+      extractConnectScopes(`const S = ''; function f(u: URL) { u.searchParams.set('scope', S); }`),
+    ).toThrow(/пуст/);
+    expect(() =>
+      extractConnectScopes(`const S = 'mcp:* mcp:*'; function f(u: URL) { u.searchParams.set('scope', S); }`),
+    ).toThrow(/дважды/);
+  });
+});

package/scripts/emit-personal-link-carrier.mjs

@@ -0,0 +1,31 @@
+// Доказательный fixture исполняет schema + createRequest точного отгруженного pin.
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadShippedDefinitions } from './shipped-definitions.mjs';
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const sourceCommit = '8a8e4995a1589ed06862fab43539c97c06963255';
+const shipped = await loadShippedDefinitions(root, sourceCommit);
+const workspace_id = '00000000-0000-4000-8000-000000000001';
+const link_id = '00000000-0000-4000-8000-000000000002';
+const cases = [
+  { name: 'besales_tracked_link_create', input: { workspace_id, name: 'Synthetic personal address', slug: 'personal-fixture', target_url: 'https://school.example.test/catalog', personal_url_variable: 'AI_TRF' } },
+  { name: 'besales_tracked_link_update', input: { workspace_id, link_id, personal_url_variable: 'AI_NEXT' } },
+  { name: 'besales_tracked_link_update', input: { workspace_id, link_id, name: 'Synthetic renamed' } },
+  { name: 'besales_tracked_link_update', input: { workspace_id, link_id, personal_url_variable: null } },
+];
+const requests = cases.map(({ name, input }) => {
+  const tool = shipped.toolDefinitions.find((entry) => entry.name === name);
+  if (!tool) throw new Error(`SHIPPED_LINK_TOOL_MISSING:${name}`);
+  const parsed = tool.schema.parse(input);
+  return { name, input, request: tool.createRequest(parsed) };
+});
+const hash = createHash('sha256');
+for (const path of [...shipped.inputPaths].sort()) hash.update(path + '\0').update(execFileSync('git', ['-C', root, 'show', `${sourceCommit}:${path}`], { maxBuffer: 64 * 1024 * 1024 }));
+const serialized = JSON.stringify({ sourceCommit, inputPaths: shipped.inputPaths, sourceSha256: hash.digest('hex'), requests }, null, 2) + '\n';
+for (const path of ['../besales-api/test/fixtures/link-tracking/personal-link-mcp-carrier.json', 'src/tools/fixtures/personal-link-mcp-carrier.json']) {
+  const target = resolve(root, path); mkdirSync(dirname(target), { recursive: true }); writeFileSync(target, serialized);
+}
+console.log('personal-link carrier: shipped schema + builder, four requests emitted');

package/scripts/emit-setup-init-schemas.mjs

@@ -0,0 +1,24 @@
+// Только изменённые формы выводятся из исполняемых Zod-определений; остальные описания сохраняются.
+import { readFileSync, writeFileSync } from 'node:fs';
+import { z } from 'zod';
+import { toolDefinitions } from '../src/tools/definitions.ts';
+
+const names = [
+  'besales_platform_create_init',
+  'besales_crm_create_init',
+  'besales_datasource_create_init',
+];
+const target = new URL('../src/schemas/mcp-tools.json', import.meta.url);
+const contract = JSON.parse(readFileSync(target, 'utf8'));
+for (const name of names) {
+  const definition = toolDefinitions.find((tool) => tool.name === name);
+  const tool = contract.tools.find((tool) => tool.name === name);
+  if (!definition || !tool) throw new Error('Missing setup init contract');
+  const generated = z.toJSONSchema(definition.schema, {
+    unrepresentable: 'any',
+  });
+  if (!generated.properties?.operation_id || generated.required?.includes('operation_id'))
+    throw new Error('Operation key must remain optional');
+  tool.inputSchema.properties.operation_id = generated.properties.operation_id;
+}
+writeFileSync(target, JSON.stringify(contract, null, 2) + '\n');