@besales/mcp 0.48.0 → 1.0.0-beta.4

package/scripts/shipped-sample-candidates.mjs

@@ -0,0 +1,69 @@
+/**
+ * Отгруженная схема перечисляет все необязательные поля, но часть из них нельзя передать вместе.
+ * Эти случаи уже имеют проверенные аргументы маршрута. Минимальный образец отгруженной схемы
+ * дополняется ими только после отказа полного набора; строка протухает, когда полный набор проходит.
+ */
+export const SHIPPED_SAMPLE_FALLBACKS = Object.freeze({
+  besales_getcourse_cold_welcome_preview: {
+    reason: 'Аудитория задаётся датой или списком, текст — сообщением или рассылкой',
+    owner: 'TASK-6.19.50',
+  },
+  besales_getcourse_cold_welcome_start: {
+    reason: 'Аудитория задаётся датой или списком, текст — сообщением или рассылкой',
+    owner: 'TASK-6.19.50',
+  },
+  besales_getcourse_cold_welcome_batch_start: {
+    reason: 'Текст задаётся сообщением или сохранённой рассылкой',
+    owner: 'TASK-6.19.50',
+  },
+  besales_variable_create: {
+    reason: 'Значение рабочей области нельзя передать вместе со значением канала',
+    owner: 'TASK-6.19.50',
+  },
+  besales_variable_update: {
+    reason: 'Значение рабочей области нельзя передать вместе со значением канала',
+    owner: 'TASK-6.19.50',
+  },
+  besales_broadcast_schedule_preview: {
+    reason: 'Дни недели и числа месяца задают разные режимы повтора',
+    owner: 'TASK-6.19.50',
+  },
+  'besales_broadcast_schedule_upsert@create': {
+    reason: 'Дни недели и числа месяца несовместимы; идентификатор расписания меняет ветку создания',
+    owner: 'TASK-6.19.50',
+  },
+  'besales_broadcast_schedule_upsert@update': {
+    reason: 'Дни недели и числа месяца задают разные режимы повтора',
+    owner: 'TASK-6.19.50',
+  },
+  'besales_broadcast_pool_today@refresh': {
+    reason: 'Локальный день переключает заказ расчёта на чтение истории',
+    owner: 'TASK-6.19.50',
+  },
+  'besales_broadcast_pool_today@history': {
+    reason: 'Исторический день несовместим с параметрами нового расчёта',
+    owner: 'TASK-6.19.50',
+  },
+});
+
+/** Проверенные значения замещают заглушки, включая значения внутри массивов. */
+export function mergeShippedArgs(sampled, known) {
+  if (Array.isArray(known)) {
+    if (!Array.isArray(sampled) || sampled.length === 0) return known;
+    return known.map((item) => mergeShippedArgs(sampled[0], item));
+  }
+  if (known === null || typeof known !== 'object') return known;
+  if (sampled === null || typeof sampled !== 'object' || Array.isArray(sampled)) return known;
+  const out = { ...sampled };
+  for (const [key, value] of Object.entries(known)) out[key] = mergeShippedArgs(sampled[key], value);
+  return out;
+}
+
+/** Полный отгруженный набор обязателен первым; узкий набор разрешён лишь поимённым случаям. */
+export function shippedSampleCandidates(key, full, required, known) {
+  const candidates = [mergeShippedArgs(full, known)];
+  if (Object.hasOwn(SHIPPED_SAMPLE_FALLBACKS, key)) {
+    candidates.push(mergeShippedArgs(required, known));
+  }
+  return candidates;
+}

package/scripts/shipped-sample-candidates.spec.mjs

@@ -0,0 +1,117 @@
+import { readFileSync } from 'node:fs';
+
+import { describe, expect, it } from 'vitest';
+
+import { resetSampleUid, sample } from './sample-args.mjs';
+import {
+  SHIPPED_SAMPLE_FALLBACKS,
+  shippedSampleCandidates,
+} from './shipped-sample-candidates.mjs';
+
+const inputRegistry = JSON.parse(
+  readFileSync(new URL('../src/schemas/mcp-tools.json', import.meta.url), 'utf8'),
+);
+const inputRouteMap = JSON.parse(
+  readFileSync(new URL('../src/schemas/mcp-v2-route-map.json', import.meta.url), 'utf8'),
+);
+const inputSchemas = new Map(inputRegistry.tools.map((tool) => [tool.name, tool.inputSchema]));
+const inputRoutes = new Map(inputRouteMap.map((row) => [row.tool, row.canonicalArgs]));
+
+function candidatesFor(inputKey) {
+  const inputName = inputKey.split('@')[0];
+  const inputSchema = inputSchemas.get(inputName);
+  const inputKnown = inputRoutes.get(inputKey);
+  expect(inputSchema).toBeDefined();
+  expect(inputKnown).toBeDefined();
+  resetSampleUid();
+  return shippedSampleCandidates(
+    inputKey,
+    sample(inputSchema, '', 0, false),
+    sample(inputSchema, '', 0, true),
+    inputKnown,
+  );
+}
+
+describe('образец отгруженного вызова при условных полях', () => {
+  it('каждый запасной набор имеет причину, задачу-владельца и строку маршрута', () => {
+    for (const [inputKey, inputEntry] of Object.entries(SHIPPED_SAMPLE_FALLBACKS)) {
+      expect(inputEntry.reason.trim()).not.toBe('');
+      expect(inputEntry.owner).toMatch(/^TASK-\d+(?:\.\d+)+$/u);
+      expect(inputRoutes.has(inputKey)).toBe(true);
+      const actualCandidates = candidatesFor(inputKey);
+      expect(actualCandidates).toHaveLength(2);
+      expect(actualCandidates[0]).not.toEqual(actualCandidates[1]);
+      expect(actualCandidates[1]).toMatchObject(inputRoutes.get(inputKey));
+    }
+  });
+
+  it('холодный запуск выбирает одну аудиторию и один источник текста', () => {
+    for (const inputKey of [
+      'besales_getcourse_cold_welcome_preview',
+      'besales_getcourse_cold_welcome_start',
+    ]) {
+      const [actualFull, actualFallback] = candidatesFor(inputKey);
+      expect(actualFull.contacts).toBeDefined();
+      expect(actualFull.mailing_variant_id).toBeDefined();
+      expect(actualFallback.created_after).toBeDefined();
+      expect(actualFallback.message).toBeDefined();
+      expect(actualFallback.contacts).toBeUndefined();
+      expect(actualFallback.mailing_variant_id).toBeUndefined();
+    }
+    const [actualFullBatch, actualFallbackBatch] = candidatesFor(
+      'besales_getcourse_cold_welcome_batch_start',
+    );
+    expect(actualFullBatch.mailing_variant_id).toBeDefined();
+    expect(actualFallbackBatch.message).toBeDefined();
+    expect(actualFallbackBatch.mailing_variant_id).toBeUndefined();
+  });
+
+  it('переменные канала не получают значение уровня рабочего пространства', () => {
+    for (const inputKey of ['besales_variable_create', 'besales_variable_update']) {
+      const [actualFull, actualFallback] = candidatesFor(inputKey);
+      expect(actualFull.value).toBeDefined();
+      expect(actualFallback.scope).toBe('CHANNEL');
+      expect(actualFallback.constant_value).toBeDefined();
+      expect(actualFallback.value).toBeUndefined();
+    }
+  });
+
+  it('образец расписания держит одну ось повтора и свою ветку сохранения', () => {
+    for (const inputKey of [
+      'besales_broadcast_schedule_preview',
+      'besales_broadcast_schedule_upsert@create',
+      'besales_broadcast_schedule_upsert@update',
+    ]) {
+      const [actualFull, actualFallback] = candidatesFor(inputKey);
+      expect(actualFull.days_of_month).toBeDefined();
+      expect(actualFallback.days_of_week).toBeDefined();
+      expect(actualFallback.days_of_month).toBeUndefined();
+    }
+    const [, actualCreate] = candidatesFor('besales_broadcast_schedule_upsert@create');
+    const [, actualUpdate] = candidatesFor('besales_broadcast_schedule_upsert@update');
+    expect(actualCreate.schedule_id).toBeUndefined();
+    expect(actualUpdate.schedule_id).toBeDefined();
+  });
+
+  it('пул различает заказ расчёта и чтение истории', () => {
+    const [actualFullRefresh, actualFallbackRefresh] = candidatesFor(
+      'besales_broadcast_pool_today@refresh',
+    );
+    const [actualFullHistory, actualFallbackHistory] = candidatesFor(
+      'besales_broadcast_pool_today@history',
+    );
+    expect(actualFullRefresh.local_day).toBeDefined();
+    expect(actualFallbackRefresh.local_day).toBeUndefined();
+    expect(actualFallbackRefresh.window_days).toBeDefined();
+    expect(actualFullHistory.window_days).toBeDefined();
+    expect(actualFallbackHistory.local_day).toBeDefined();
+    expect(actualFallbackHistory.window_days).toBeUndefined();
+  });
+
+  it('необъявленный случай не получает запасной набор', () => {
+    const inputKey = 'besales_workspace_current';
+    const inputKnown = { workspace_id: '00000000-0000-4000-8000-000000000001' };
+    const actualCandidates = shippedSampleCandidates(inputKey, {}, {}, inputKnown);
+    expect(actualCandidates).toEqual([inputKnown]);
+  });
+});