neuroalpha 0.3.16 → 0.5.1

package/server/strategist/tools.js

@@ -1,532 +1,675 @@
-// Copyright (c) 2026 Roman A. Perepelkin. All rights reserved. Proprietary software.
-import { PARAMS, PARAM_MAP } from '../params-meta.js';
-import { getSettings, updateSettings, validateChanges } from '../settings.js';
-import { getRun, listRuns, addJournal, listJournal, kvGet, kvSet } from '../db.js';
-import { analyzeRun, compareRuns, recentRuns, runSummary, compactMetrics } from './analytics.js';
-import { hub } from '../hub.js';
-import { startModelResearch } from '../model/research.js';
-import { forecastNow } from '../model/forecast.js';
-import { live } from '../model/live.js';
-import { listNews } from '../news/index.js';
-import { BROKER_META, brokersState, discoverBrokerAccounts, saveBrokerAccount, syncBrokerAccount, prepareBrokerOrders } from '../brokers/index.js';
-import { plural, fmtBarMsk } from '../util.js';
-
-export const OOS_LIMIT = 3;
-const AI_LOCKED = PARAMS.filter((p) => p.ai === false).map((p) => p.key);
-
-const changesSchema = {
-  type: 'object',
-  description: 'Изменения настроек: ключ — точное название настройки из списка в системной инструкции (например modelHorizon, modelMinEdge), значение — новое значение.',
-  properties: Object.fromEntries(PARAMS.filter((p) => p.ai !== false && !p.hidden && !p.fixed).map((p) => [p.key, {
-    type: p.type === 'checkbox' ? 'boolean' : p.type === 'select' ? 'string' : 'number',
-    description: `${p.label}${p.min !== undefined ? ` (${p.min}–${p.max})` : ''}`,
-  }])),
-  additionalProperties: false,
-};
-
-function checkChanges(changes) {
-  const locked = Object.keys(changes || {}).filter((k) => AI_LOCKED.includes(k));
-  const { values, errors } = validateChanges(changes);
-  for (const k of locked) { errors.push(`${k}: эту настройку ИИ менять нельзя (она отвечает за честность проверки)`); delete values[k]; }
-  return { values, errors };
-}
-
-const describeChanges = (values) => Object.entries(values).map(([k, v]) => `${PARAM_MAP[k]?.label || k}: ${v}`).join('; ') || 'без изменений';
-const fmtPct = (v) => (v === null || v === undefined ? '—' : `${v > 0 ? '+' : ''}${v}%`);
-const metricLine = (m) => (m && !m.trades ? 'сделок не было' : m ? `${m.trades} ${plural(m.trades, 'сделка', 'сделки', 'сделок')}, итог ${fmtPct(m.returnPct)}, на 1 ₽ убытка ${m.profitFactor ?? '—'} ₽, худшее падение ${m.maxDrawdownPct}%` : 'нет данных');
-
-// Последнее исследование с текущими настройками (база для сравнения)
-function findBaseline(excludeId) {
-  const cur = getSettings();
-  const keys = PARAMS.map((p) => p.key).filter((k) => !['capital', 'paperDailyReview', 'paperPollSec', 'autopilotBudget'].includes(k));
-  return listRuns().find((r) => r.id !== excludeId && r.mode === 'model' && r.status === 'done'
-    && keys.every((k) => JSON.stringify(r.params?.[k] ?? null) === JSON.stringify(cur[k] ?? null))) || null;
-}
-
-// kind: read — без подтверждения; write — подтверждение в режиме «Советник»; danger — подтверждение всегда;
-// confirmAlways — подтверждение во всех режимах (кроме read-режимов, где инструмент недоступен)
-export const TOOLS = {
-  get_settings: {
-    kind: 'read',
-    label: 'Смотрит текущие настройки',
-    description: 'Текущие настройки модели и счёта с пояснениями.',
-    parameters: { type: 'object', properties: {} },
-    async run() {
-      const s = getSettings();
-      return {
-        result: Object.fromEntries(PARAMS.map((p) => [p.key, { значение: s[p.key], что_это: p.label, пояснение: p.hint, ...(p.ai === false ? { менять_нельзя: true } : {}) }])),
-        summary: 'Прочитал текущие настройки',
-      };
-    },
-  },
-
-  list_runs: {
-    kind: 'read',
-    label: 'Смотрит список исследований',
-    description: 'Последние исследования модели и живые проверки с результатами на периоде настройки.',
-    parameters: { type: 'object', properties: { limit: { type: 'number', description: 'сколько последних, по умолчанию 10' } } },
-    async run({ limit = 10 }) {
-      return { result: recentRuns(Math.min(30, limit)), summary: `Просмотрел последние исследования` };
-    },
-  },
-
-  analyze_run: {
-    kind: 'read',
-    label: 'Разбирает исследование',
-    description: 'Подробный разбор исследования: сравнение моделей, сделки торгующей модели по акциям, часу входа, сроку удержания, веса голов внимания. Только период настройки.',
-    parameters: { type: 'object', properties: { run_id: { type: 'number', description: 'номер исследования' } }, required: ['run_id'] },
-    async run({ run_id }) {
-      const r = analyzeRun(Number(run_id));
-      return { result: r, summary: r.ошибка || `Разобрал исследование №${run_id}` };
-    },
-  },
-
-  compare_runs: {
-    kind: 'read',
-    label: 'Сравнивает исследования',
-    description: 'Сравнить два исследования: чем отличаются настройки и результаты на периоде настройки.',
-    parameters: { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } }, required: ['a', 'b'] },
-    async run({ a, b }) {
-      return { result: compareRuns(Number(a), Number(b)), summary: `Сравнил исследования №${a} и №${b}` };
-    },
-  },
-
-  run_model_research: {
-    kind: 'write',
-    budget: true,
-    label: 'Исследует модель',
-    description: 'Пошаговая проверка трёх моделей предсказания «следующего состояния рынка» (~100 акций, часовые свечи): своя инерция, кто за кем ходит, внимание через карту рынка (и трансформер, если modelUseTransformer=true — тогда в разы дольше). Модель учится на окне прошлого, прогнозирует следующий месяц, окно сдвигается. Возвращает сравнение моделей на периоде настройки и базу для сравнения. Можно передать изменения настроек (сами настройки не меняются). Около минуты.',
-    parameters: { type: 'object', properties: { changes: changesSchema, note: { type: 'string', description: 'что проверяем (гипотеза)' } }, required: ['note'] },
-    preview(args) {
-      const { values, errors } = checkChanges(args.changes);
-      return `${args.note || 'Исследование модели'}\nИзменения: ${describeChanges(values)}${errors.length ? `\nОшибки: ${errors.join('; ')}` : ''}`;
-    },
-    async run(args, ctx) {
-      const { values, errors } = checkChanges(args.changes);
-      if (errors.length) return { result: { ошибка: errors }, summary: `Ошибка в изменениях: ${errors.join('; ')}`, ok: false };
-      const { runId, done, reused } = startModelResearch({ ...getSettings(), ...values }, { source: 'ai', note: args.note || '' });
-      ctx.onRunStart?.(runId);
-      try { await done; } catch (e) {
-        return { result: { исследование: runId, ошибка: e.message }, summary: `Исследование №${runId}: ${e.message}`, ok: false };
-      }
-      const run = getRun(runId);
-      const base = findBaseline(runId);
-      const c = run.metrics?.model?.comparison?.attention?.inSample;
-      return {
-        result: {
-          ...runSummary(run),
-          изменения: values,
-          ...(reused ? { повтор: `результат взят из исследования №${runId} с теми же настройками` } : {}),
-          база_для_сравнения: base ? runSummary(base) : 'нет исследования с текущими настройками без изменений — для честного сравнения запусти run_model_research без changes',
-        },
-        summary: reused
-          ? `Исследование №${runId} (готовый результат): внимание через карту — совпадение ${c?.ic}, итог ${fmtPct(c?.returnPct)} (без комиссий ${fmtPct(c?.grossReturnPct)}), ${c?.trades} сделок (период настройки)`
-          : `Исследование №${runId}: внимание через карту — совпадение ${c?.ic}, итог ${fmtPct(c?.returnPct)} (без комиссий ${fmtPct(c?.grossReturnPct)}), ${c?.trades} сделок (период настройки)`,
-        runId,
-      };
-    },
-  },
-
-  model_forecast: {
-    kind: 'read',
-    label: 'Смотрит прогноз на ближайшие часы',
-    description: 'Прогноз модели по последней закрытой свече: какие акции, по её мнению, будут сильнее или слабее рынка в ближайшие часы и под чьим влиянием (соседи по карте).',
-    parameters: { type: 'object', properties: { top: { type: 'number', description: 'сколько акций показать, по умолчанию 10' } } },
-    async run({ top = 10 }) {
-      const r = await forecastNow(getSettings());
-      const pick = (x) => ({ акция: x.symbol, ожидание_проц: x.expectedPct, сигнал_покупки: !!x.signal, ...(x.shortSignal !== undefined ? { сигнал_продажи: !!x.shortSignal } : {}), ликвидна: x.liquid, последний_час_проц: x.lastMovePct, влияют: x.influences.map((n) => `${n.symbol} (${n.contribPct > 0 ? '+' : ''}${n.contribPct}%, близость ${n.closeness})`), своё_движение_проц: x.selfPct });
-      return {
-        result: { свеча: r.bar, горизонт_часов: r.horizon, порог_покупки_проц: r.thresholdPct, сильнее_рынка: r.rows.slice(0, top).map(pick), слабее_рынка: r.rows.slice(-Math.min(5, top)).map(pick) },
-        summary: `Прогноз на свече ${r.bar}: сигналов покупки ${r.rows.filter((x) => x.signal).length}`,
-      };
-    },
-  },
-
-  market_neighbors: {
-    kind: 'read',
-    label: 'Смотрит соседей на карте',
-    description: 'Ближайшие соседи акции на карте рынка (кто движется похоже) и её группа — по последнему исследованию.',
-    parameters: { type: 'object', properties: { symbol: { type: 'string' } }, required: ['symbol'] },
-    async run({ symbol }) {
-      const run = listRuns().find((r) => r.mode === 'model' && r.status === 'done');
-      const ex = run && getRun(run.id).extra;
-      if (!ex) return { result: { ошибка: 'нет исследования — запусти run_model_research' }, summary: 'Нет исследования', ok: false };
-      const i = ex.symbols.indexOf(String(symbol).toUpperCase());
-      if (i < 0) return { result: { ошибка: `${symbol} нет в словаре модели` }, summary: `${symbol} нет в словаре`, ok: false };
-      const snap = ex.map.snapshots.at(-1);
-      return {
-        result: { акция: ex.symbols[i], соседи: ex.neighbors[i].map(([k, c]) => ({ акция: ex.symbols[k], близость: c })), группа_на_карте: ex.symbols.filter((_, k) => snap.cl[k] === snap.cl[i]) },
-        summary: `Соседи ${ex.symbols[i]}: ${ex.neighbors[i].slice(0, 4).map(([k]) => ex.symbols[k]).join(', ')}`,
-      };
-    },
-  },
-
-  get_news: {
-    kind: 'read',
-    label: 'Смотрит свежие новости',
-    description: 'Свежие новости и раскрытия эмитентов: каких акций из словаря касаются, тон −1…1 (плохо/хорошо для акции), важность 0…1 и короткая суть. Без symbol — все важные новости за период. Новости есть только «сейчас»: в исторических проверках они не используются.',
-    parameters: {
-      type: 'object',
-      properties: {
-        symbol: { type: 'string', description: 'тикер, например SBER; без него — все важные новости' },
-        hours: { type: 'number', description: 'за сколько часов смотреть, по умолчанию 24' },
-      },
-    },
-    async run({ symbol, hours = 24 }) {
-      const items = listNews({ symbol, hours, limit: 25 });
-      if (!items.length) return { result: { новостей: 'нет' }, summary: `Новостей ${symbol ? `по ${symbol}` : ''} за последние ${hours} ч нет` };
-      return {
-        result: items.map((n) => ({
-          время: fmtBarMsk(n.ts), источник: n.src,
-          ...(n.symbols.length ? { акции: n.symbols.map((s) => `${s.symbol} (тон ${s.tone ?? '—'})`) } : {}),
-          ...(n.imp !== null ? { важность: n.imp } : {}), суть: n.gist || n.title, ссылка: n.link,
-        })),
-        summary: `Новости за ${hours} ч: ${items.length}${symbol ? ` по ${symbol}` : ''}`,
-      };
-    },
-  },
-
-  journal_list: {
-    kind: 'read',
-    label: 'Читает журнал гипотез',
-    description: 'Полный журнал гипотез: что уже проверяли и к каким выводам пришли.',
-    parameters: { type: 'object', properties: {} },
-    async run() {
-      return { result: listJournal(100), summary: 'Прочитал журнал гипотез' };
-    },
-  },
-
-  journal_add: {
-    kind: 'read',
-    label: 'Записывает вывод в журнал',
-    description: 'Записать в журнал гипотез результат эксперимента. Делай это после каждого законченного эксперимента.',
-    parameters: {
-      type: 'object',
-      properties: {
-        hypothesis: { type: 'string', description: 'что предполагали, простыми словами' },
-        change: { type: 'string', description: 'что меняли' },
-        run_ids: { type: 'array', items: { type: 'number' }, description: 'номера исследований: базовое и новое' },
-        result: { type: 'string', description: 'что получилось, с цифрами и числом сделок' },
-        verdict: { type: 'string', enum: ['confirmed', 'rejected', 'unclear'], description: 'подтвердилась / не подтвердилась / неясно' },
-      },
-      required: ['hypothesis', 'result', 'verdict'],
-    },
-    async run(args) {
-      const id = addJournal({ ...args, source: 'ai' });
-      hub.emit({ type: 'journal:update' });
-      const v = { confirmed: 'подтвердилась', rejected: 'не подтвердилась', unclear: 'неясно' }[args.verdict] || args.verdict;
-      return { result: { ok: true, id }, summary: `Записал в журнал: «${args.hypothesis}» — ${v}` };
-    },
-  },
-
-  final_check: {
-    kind: 'read',
-    label: 'Смотрит контрольный период',
-    description: `Открыть результат исследования на КОНТРОЛЬНОМ периоде (данные, которые не используются для подбора). Не больше ${OOS_LIMIT} раз за разговор — только для финальной оценки лучшего варианта против базы.`,
-    parameters: { type: 'object', properties: { run_id: { type: 'number' } }, required: ['run_id'] },
-    async run({ run_id }, ctx) {
-      const key = `oos_used_${ctx.convId}`;
-      const used = kvGet(key, []);
-      if (!used.includes(Number(run_id)) && used.length >= OOS_LIMIT) {
-        return { result: { ошибка: `лимит ${OOS_LIMIT} просмотров контрольного периода за разговор исчерпан` }, summary: 'Лимит просмотров контрольного периода исчерпан', ok: false };
-      }
-      const run = getRun(Number(run_id));
-      if (!run) return { result: { ошибка: 'нет такого исследования' }, summary: 'Нет такого исследования', ok: false };
-      if (!used.includes(Number(run_id))) kvSet(key, [...used, Number(run_id)]);
-      return {
-        result: { ...runSummary(run, { revealOOS: true }), осталось_просмотров: OOS_LIMIT - kvGet(key, []).length },
-        summary: `Контрольный период №${run_id}: ${metricLine(run.metrics?.outOfSample)}`,
-      };
-    },
-  },
-
-  set_settings: {
-    kind: 'write',
-    confirmAlways: true,
-    label: 'Меняет настройки',
-    description: 'Сохранить изменения в рабочие настройки (их видит пользователь и использует живая проверка). Только когда изменение подтверждено исследованиями.',
-    parameters: { type: 'object', properties: { changes: changesSchema, reason: { type: 'string', description: 'почему' } }, required: ['changes', 'reason'] },
-    preview(args) {
-      const { values, errors } = checkChanges(args.changes);
-      return `${args.reason || ''}\nИзменения: ${describeChanges(values)}${errors.length ? `\nОшибки: ${errors.join('; ')}` : ''}`;
-    },
-    async run(args) {
-      const { values, errors } = checkChanges(args.changes);
-      const r = updateSettings(values, { source: 'ai', reason: args.reason });
-      const all = [...errors, ...r.errors];
-      return {
-        result: { изменено: r.changed, ошибки: all.length ? all : undefined },
-        summary: Object.keys(r.changed).length ? `Настройки изменены: ${describeChanges(Object.fromEntries(Object.entries(r.changed).map(([k, v]) => [k, v.стало])))}` : `Настройки не изменились${all.length ? `: ${all.join('; ')}` : ''}`,
-        ok: !all.length,
-      };
-    },
-  },
-
-  paper_start: {
-    kind: 'danger',
-    label: 'Запускает живую проверку',
-    description: 'Запустить живую проверку модели (виртуальная торговля на текущих ценах) с текущими настройками.',
-    parameters: { type: 'object', properties: { reason: { type: 'string' } } },
-    preview: (args) => args.reason || 'Запустить живую проверку с текущими настройками',
-    async run() {
-      if (live.status().running) return { result: { ошибка: 'уже запущена' }, summary: 'Живая проверка уже запущена', ok: false };
-      const runId = await live.start(getSettings(), { source: 'ai' });
-      return { result: { ok: true, проверка: runId }, summary: `Живая проверка №${runId} запущена` };
-    },
-  },
-
-  paper_stop: {
-    kind: 'danger',
-    label: 'Останавливает живую проверку',
-    description: 'Остановить живую проверку.',
-    parameters: { type: 'object', properties: { reason: { type: 'string' } } },
-    preview: (args) => args.reason || 'Остановить живую проверку',
-    async run() {
-      const st = live.status();
-      if (!st.running) return { result: { ошибка: 'не запущена' }, summary: 'Живая проверка не запущена', ok: false };
-      live.stop();
-      return { result: { ok: true, итог: compactMetrics(getRun(st.runId)?.metrics?.full) }, summary: `Живая проверка №${st.runId} остановлена` };
-    },
-  },
-
-  broker_onboarding_guide: {
-    kind: 'read',
-    label: 'Справка по открытию и подключению брокерского счёта',
-    description: 'Получить подробную инструкцию по открытию брокерского счёта, включению маржинальной торговли, выпуску API-токена и список уже подключённых счетов пользователя.',
-    parameters: {
-      type: 'object',
-      properties: {
-        broker: {
-          type: 'string',
-          enum: ['tbank', 'finam', 'bcs', 'alor', 'cifra', 'iticapital', 'sber', 'vtb', 'alfa'],
-          description: 'код выбранного брокера',
-        },
-      },
-    },
-    async run({ broker = 'tbank' } = {}) {
-      const st = brokersState();
-      const meta = BROKER_META.find((b) => b.id === broker) || BROKER_META[0];
-      const guides = {
-        tbank: {
-          openAccountUrl: 'https://www.tbank.ru/invest/',
-          tokenUrl: 'https://www.tbank.ru/invest/settings/',
-          accountTypeAdvice: 'Открывайте обычный «Брокерский счёт» (не Инвесткопилку и не счёт автоследования; для шортов на тарифах Профи/VIP нужен обычный брокерский счёт с включённой маржинальной торговлей).',
-          stepsToGetToken: [
-            '1. Откройте веб-кабинет Т-Инвестиций: https://www.tbank.ru/invest/settings/ (раздел «Токены T-Invest API»).',
-            '2. Нажмите «Выпустить токен» → выберите «Полный доступ» (для выставления заявок) и «Все счета».',
-            '3. Скопируйте токен (начинается с t.…) и пришлите его сюда в чат или вставьте в форму — я сам найду все ваши субсчета через discover_broker_accounts и подключу нужный счёт.',
-            '4. Чтобы стратегия зарабатывала и на падении акций (шорт), в мобильном приложении Т-Инвестиций зайдите в настройки выбранного счёта (шестерёнка вверху справа) и включите «Маржинальная торговля».',
-          ],
-        },
-        finam: {
-          openAccountUrl: 'https://www.finam.ru/',
-          tokenUrl: 'https://edox.finam.ru/',
-          accountTypeAdvice: 'Единый брокерский счёт Мосбиржи (КлФ / ЕДП).',
-          stepsToGetToken: [
-            '1. В кабинете клиента Финам (edox.finam.ru) откройте «Торговля → Токены доступа (Finam Trade API)».',
-            '2. Выпустите новый токен (начинается на CA…) и скопируйте ваш торговый код клиента ClientId (например 123456R).',
-            '3. Пришлите токен и ClientId или нажмите кнопку подтверждения — я подключу счёт через connect_broker_account.',
-          ],
-        },
-        bcs: {
-          openAccountUrl: 'https://bcs.ru/',
-          tokenUrl: 'https://my.broker.ru/',
-          accountTypeAdvice: 'Обычный брокерский счёт БКС Мир инвестиций с доступом к Мосбирже TQBR.',
-          stepsToGetToken: [
-            '1. В веб-терминале «БКС Мир инвестиций» откройте Настройки профиля → «Торговый API (BCS Trade API)».',
-            '2. Выпустите Refresh-токен с правом «Чтение и торговля» (trade-api-write).',
-            '3. Передайте Refresh-токен — я создам и синхронизирую счёт.',
-          ],
-        },
-        alor: {
-          openAccountUrl: 'https://www.alorbroker.ru/',
-          tokenUrl: 'https://alor.dev/',
-          accountTypeAdvice: 'Фондовый счёт Мосбиржи (портфель с литерой D, например D12345).',
-          stepsToGetToken: [
-            '1. Авторизуйтесь под брокерским аккаунтом на портале разработчика https://alor.dev (или в кабинете my.alor.ru → OpenAPI).',
-            '2. Выпустите Refresh Token для боевого контура и укажите номер портфеля D…',
-          ],
-        },
-        cifra: {
-          openAccountUrl: 'https://cifra-broker.ru/',
-          tokenUrl: 'https://tradernet.ru/',
-          accountTypeAdvice: 'Брокерский счёт Tradernet (Мосбиржа).',
-          stepsToGetToken: [
-            '1. В кабинете tradernet.ru откройте Настройки профиля → «API ключи».',
-            '2. Сгенерируйте пару ключей PublicKey и SecretKey и передайте их через двоеточие: PublicKey:SecretKey.',
-          ],
-        },
-        iticapital: {
-          openAccountUrl: 'https://iticapital.ru/',
-          tokenUrl: 'https://iticapital.ru/',
-          accountTypeAdvice: 'Фондовый портфель Мосбиржи вида BP12345.',
-          stepsToGetToken: [
-            '1. В личном кабинете ITI Capital откройте «Торговые системы → OpenAPI» и выпустите Refresh Token.',
-            '2. Укажите Refresh-токен и код портфеля BP…',
-          ],
-        },
-        sber: {
-          openAccountUrl: 'https://www.sberbank.ru/ru/person/investments',
-          accountTypeAdvice: 'Обычный брокерский счёт СберИнвестиций.',
-          stepsToGetToken: [
-            'У СберИнвестиций нет облачного REST-токена для физлиц, поэтому счёт подключается БЕЗ токена в режиме «Подтверждение заявок» (или через адрес локального HTTP-шлюза QUIK).',
-            'Достаточно указать желаемый лимит суммы на стратегию (например 100 000 ₽) и номер счёта — я сразу создам счёт в платформе через connect_broker_account и рассчитаю первые заявки в лотах Мосбиржи!',
-          ],
-        },
-        vtb: {
-          openAccountUrl: 'https://broker.vtb.ru/',
-          accountTypeAdvice: 'Обычный брокерский счёт ВТБ Мои Инвестиции.',
-          stepsToGetToken: [
-            'У ВТБ Мои Инвестиции нет облачного REST-токена для физлиц — счёт подключается без токена в режиме «Подтверждение заявок» (с уведомлениями в Telegram/MAX и учётом портфеля) или через адрес моста QUIK.',
-          ],
-        },
-        alfa: {
-          openAccountUrl: 'https://alfabank.ru/make-money/investments/',
-          accountTypeAdvice: 'Обычный брокерский счёт Альфа-Инвестиций.',
-          stepsToGetToken: [
-            'У Альфа-Инвестиций нет облачного REST-токена для физлиц — счёт подключается без токена в режиме «Подтверждение заявок» или через адрес моста QUIK.',
-          ],
-        },
-      };
-      return {
-        result: {
-          брокер: meta,
-          инструкция: guides[broker] || guides.tbank,
-          уже_подключённые_счета: st.accounts.map((a) => ({
-            id: a.id,
-            название: a.name,
-            брокер: a.broker,
-            субсчёт: a.accountId,
-            режим: a.mode,
-            лимит_руб: a.maxCapitalRub,
-            баланс_руб: a.lastSync?.totalRub ?? null,
-            маржиналка: a.lastSync?.marginEnabled ?? null,
-          })),
-        },
-        summary: `Загрузил инструкцию по подключению брокера «${meta.name}»`,
-      };
-    },
-  },
-
-  discover_broker_accounts: {
-    kind: 'read',
-    label: 'Ищет субсчета брокера по токену',
-    description: 'Найти все открытые брокерские субсчета пользователя в Т-Банке (T-Invest API) по токену, показать их баланс, статус маржинальной торговли и проверить отсутствие автоследования.',
-    parameters: {
-      type: 'object',
-      properties: {
-        token: { type: 'string', description: 'Токен T-Invest API (начинается на t.…)' },
-        sandbox: { type: 'boolean', description: 'Контур песочницы (по умолчанию false)' },
-      },
-      required: ['token'],
-    },
-    async run({ token, sandbox = false }) {
-      const r = await discoverBrokerAccounts({ broker: 'tbank', token, sandbox });
-      return {
-        result: {
-          найдено_счетов: r.accounts.length,
-          счета: r.accounts.map((a) => ({
-            accountId: a.id,
-            название: a.name,
-            тип: a.type,
-            доступ: a.access,
-            баланс_руб: a.totalRub,
-            свободные_рубли: a.cashRub,
-            позиций: a.positionsCount,
-            маржинальная_торговля: a.marginEnabled ? 'включена (шорты доступны)' : 'выключена (только в рост)',
-            автоследование: a.autoFollowDetected ? 'ОБНАРУЖЕНО (подключать запрещено Офертой)' : 'нет (можно подключать)',
-            пригодность: a.eligibleForTrading ? 'подходит для торговли' : 'только просмотр / копилка',
-          })),
-        },
-        summary: `Найдено счетов в Т-Банке: ${r.accounts.length}`,
-      };
-    },
-  },
-
-  connect_broker_account: {
-    kind: 'write',
-    confirmAlways: true,
-    label: 'Подключает брокерский счёт',
-    description: 'Добавить или обновить брокерский счёт в платформе «НейроАльфа», сразу выполнить синхронизацию портфеля и рассчитать стартовый пакет заявок.',
-    parameters: {
-      type: 'object',
-      properties: {
-        id: { type: 'string', description: 'ID существующего счёта в платформе (если обновляем существующий счёт)' },
-        broker: {
-          type: 'string',
-          enum: ['tbank', 'finam', 'bcs', 'alor', 'cifra', 'iticapital', 'sber', 'vtb', 'alfa'],
-          description: 'Код брокера',
-        },
-        name: { type: 'string', description: 'Понятное название счёта (например «Т-Банк основной»)' },
-        token: { type: 'string', description: 'API-токен / Refresh-токен (для Сбера/ВТБ/Альфы без QUIK оставьте пустым)' },
-        accountId: { type: 'string', description: 'ID субсчёта / ClientId / номер портфеля' },
-        mode: { type: 'string', enum: ['readonly', 'confirm', 'auto'], description: 'Режим работы: confirm (подтверждение заявок), auto (автомат) или readonly' },
-        legacyMode: { type: 'string', enum: ['isolate', 'smooth', 'takeover'], description: 'Защита старых бумаг: isolate (не трогать старые бумаги, по умолчанию), smooth или takeover' },
-        maxCapitalRub: { type: 'number', description: 'Лимит суммы на стратегию в рублях (по умолчанию 100000)' },
-        maxDailyDrawdownPct: { type: 'number', description: 'Дневной стоп по просадке в % (по умолчанию 3)' },
-        limitOffsetPct: { type: 'number', description: 'Защитный отступ лимитной заявки в % (по умолчанию 0.1)' },
-      },
-      required: ['broker'],
-    },
-    preview(args) {
-      const meta = BROKER_META.find((b) => b.id === args.broker);
-      const modeLbl = { readonly: 'Только чтение', confirm: 'Подтверждение заявок', auto: 'Автомат' }[args.mode || 'confirm'] || 'Подтверждение заявок';
-      return `Брокер: ${meta?.name || args.broker}${args.name ? ` («${args.name}»)` : ''}${args.accountId ? ` · счёт ${args.accountId}` : ''} · режим «${modeLbl}» · лимит ${args.maxCapitalRub || 100000} ₽`;
-    },
-    async run(args) {
-      const beforeIds = new Set(brokersState().accounts.map((a) => a.id));
-      const st = saveBrokerAccount({
-        id: args.id,
-        broker: args.broker,
-        name: args.name,
-        token: args.token,
-        accountId: args.accountId,
-        mode: args.mode || 'confirm',
-        legacyMode: args.legacyMode || 'isolate',
-        maxCapitalRub: args.maxCapitalRub || 100000,
-        maxDailyDrawdownPct: args.maxDailyDrawdownPct ?? 3,
-        limitOffsetPct: args.limitOffsetPct ?? 0.1,
-      });
-      const created = args.id ? st.accounts.find((a) => a.id === args.id) : st.accounts.find((a) => !beforeIds.has(a.id)) || st.accounts[st.accounts.length - 1];
-      let syncRes = null;
-      if (created && (created.hasToken || ['sber', 'vtb', 'alfa'].includes(created.broker))) {
-        try {
-          const synced = await syncBrokerAccount(created.id);
-          await prepareBrokerOrders(created.id).catch(() => {});
-          const accNow = synced.accounts.find((a) => a.id === created.id);
-          syncRes = {
-            синхронизировано: Boolean(accNow?.lastSync?.ok),
-            ошибка_синхронизации: accNow?.lastSync?.error || null,
-            баланс_руб: accNow?.lastSync?.totalRub ?? null,
-            свободные_рубли: accNow?.lastSync?.cashRub ?? null,
-            маржинальная_торговля: accNow?.lastSync?.marginEnabled ?? null,
-            подготовлено_заявок: accNow?.pendingBatch?.orders?.length ?? 0,
-          };
-        } catch (e) {
-          syncRes = { синхронизировано: false, ошибка_синхронизации: e.message };
-        }
-      }
-      return {
-        result: {
-          ok: true,
-          счёт: created ? { id: created.id, название: created.name, брокер: created.broker, субсчёт: created.accountId, режим: created.mode, лимит_руб: created.maxCapitalRub } : null,
-          статус_подключения: syncRes,
-        },
-        summary: `Подключён брокерский счёт «${created?.name || args.broker}»${syncRes?.баланс_руб !== null && syncRes?.баланс_руб !== undefined ? ` (баланс ${syncRes.баланс_руб} ₽)` : ''}`,
-      };
-    },
-  },
-};
-
-export const MODES = {
-  discuss: { label: 'Обсуждение', allowed: (t) => t.kind === 'read' },
-  advisor: { label: 'Советник', allowed: () => true, confirm: (t) => t.kind !== 'read' },
-  autopilot: { label: 'Автопилот', allowed: () => true, confirm: (t) => t.kind === 'danger' || !!t.confirmAlways },
-  review: { label: 'Разбор дня', allowed: (t) => t.kind === 'read' },
-};
-
-export function toolSchemas(mode) {
-  return Object.entries(TOOLS)
-    .filter(([, t]) => MODES[mode].allowed(t))
-    .map(([name, t]) => ({ type: 'function', function: { name, description: t.description, parameters: t.parameters } }));
-}
+// Copyright (c) 2026 Roman A. Perepelkin. All rights reserved. Proprietary software.
+import { PARAMS, PARAM_MAP } from '../params-meta.js';
+import { getSettings, updateSettings, validateChanges } from '../settings.js';
+import { getRun, listRuns } from '../db.js';
+import { analyzeRun, compareRuns, recentRuns } from './analytics.js';
+import { forecastNow } from '../model/forecast.js';
+import { listNews } from '../news/index.js';
+import { BROKER_META, brokersState, discoverBrokerAccounts, saveBrokerAccount, syncBrokerAccount, prepareBrokerOrders, fetchBrokerHistory } from '../brokers/index.js';
+import { fmtBarMsk, fmtDayMsk, MSK, DAY, round } from '../util.js';
+
+export const OOS_LIMIT = 3;
+const AI_LOCKED = PARAMS.filter((p) => p.ai === false).map((p) => p.key);
+
+const changesSchema = {
+  type: 'object',
+  description: 'Изменения настроек: ключ — точное название настройки из списка в системной инструкции (например modelShortFeePct, newsFilter), значение — новое значение.',
+  properties: Object.fromEntries(PARAMS.filter((p) => p.ai !== false && !p.hidden && !p.fixed).map((p) => [p.key, {
+    type: p.type === 'checkbox' ? 'boolean' : p.type === 'select' ? 'string' : 'number',
+    description: `${p.label}${p.min !== undefined ? ` (${p.min}–${p.max})` : ''}`,
+  }])),
+  additionalProperties: false,
+};
+
+function checkChanges(changes) {
+  const locked = Object.keys(changes || {}).filter((k) => AI_LOCKED.includes(k));
+  const { values, errors } = validateChanges(changes);
+  for (const k of locked) { errors.push(`${k}: эту настройку ИИ менять нельзя`); delete values[k]; }
+  return { values, errors };
+}
+
+const describeChanges = (values) => Object.entries(values).map(([k, v]) => `${PARAM_MAP[k]?.label || k}: ${v}`).join('; ') || 'без изменений';
+
+export const TOOLS = {
+  get_brokers_status: {
+    kind: 'read',
+    label: 'Смотрит брокерские счета и портфель',
+    description: 'Текущий снимок подключённых брокерских счетов ПРЯМО СЕЙЧАС: баланс, свободные рубли, открытые позиции в портфеле, активные заявки в стакане и подготовленный пакет заявок. ВНИМАНИЕ: чтобы посмотреть историю прошлых сделок (как прошли торги вчера, сегодня или за неделю), вызывай get_broker_operations!',
+    parameters: { type: 'object', properties: {} },
+    async run() {
+      const st = brokersState();
+      const accs = (st.accounts || []).map((a) => ({
+        id: a.id,
+        название: a.name,
+        брокер: a.broker,
+        субсчёт: a.accountId || '—',
+        режим_работы: a.mode,
+        песочница: Boolean(a.sandbox),
+        режим_старого_портфеля: a.legacyMode || 'isolate',
+        лимит_на_стратегию_руб: a.maxCapitalRub,
+        дневной_стоп_проц: a.maxDailyDrawdownPct,
+        отступ_лимитки_проц: a.limitOffsetPct,
+        пауза_причина: a.haltedReason || null,
+        время_снимка_портфеля_мск: a.lastSync?.at ? fmtBarMsk(a.lastSync.at) : null,
+        баланс_руб: a.lastSync?.totalRub ?? null,
+        свободные_рубли: a.lastSync?.cashRub ?? null,
+        маржинальная_торговля: a.lastSync?.marginEnabled ?? null,
+        текущие_позиции_в_портфеле: (a.lastSync?.positions || []).map((p) => ({
+          тикер: p.symbol,
+          название: p.name,
+          кол_во_шт: p.qty,
+          средняя_цена: p.avgPrice,
+          текущая_цена: p.price,
+          стоимость_руб: p.valueRub,
+          доход_руб: p.pnlRub,
+          ...(a.entryTsBySymbol?.[p.symbol] ? { время_входа_робота_мск: fmtBarMsk(a.entryTsBySymbol[p.symbol]) } : {}),
+        })),
+        активные_заявки_в_стакане: a.lastSync?.activeOrders || [],
+        подготовленный_пакет_заявок: a.pendingBatch ? {
+          свеча: a.pendingBatch.bar,
+          статус: a.pendingBatch.status,
+          рабочий_бюджет_руб: a.pendingBatch.budgetRub,
+          свободно_под_вход_руб: a.pendingBatch.availRub,
+          направление: a.pendingBatch.effectiveDirection,
+          диагностика: a.pendingBatch.diagNote || null,
+          тарифная_заметка: a.pendingBatch.planThrottleNote || null,
+          заявки: a.pendingBatch.orders || [],
+        } : null,
+      }));
+      return {
+        result: {
+          текущее_время_мск: fmtBarMsk(Date.now()),
+          подключено_счетов: accs.length,
+          счета: accs,
+        },
+        summary: accs.length ? `Проверил брокерские счета (${accs.length})` : 'Брокерские счета пока не подключены',
+      };
+    },
+  },
+
+  get_broker_operations: {
+    kind: 'read',
+    label: 'Смотрит историю сделок по счёту',
+    description: 'Исполненные сделки и операции по брокерскому счёту за выбранный период (вчера, сегодня, за неделю или за конкретные даты YYYY-MM-DD): покупки, продажи, время сделок по МСК, цены, суммы, комиссии и итог торгов за период.',
+    parameters: {
+      type: 'object',
+      properties: {
+        period: {
+          type: 'string',
+          enum: ['yesterday', 'today', 'week', 'month', 'custom'],
+          description: 'yesterday — вчерашний день, today — сегодня, week — последние 7 дней, month — последние 30 дней, custom — по датам fromDate/toDate',
+        },
+        fromDate: {
+          type: 'string',
+          description: 'начальная дата в формате YYYY-MM-DD по МСК (необязательно, если задан period)',
+        },
+        toDate: {
+          type: 'string',
+          description: 'конечная дата в формате YYYY-MM-DD по МСК (необязательно, если задан period)',
+        },
+        accountId: {
+          type: 'string',
+          description: 'id счёта в платформе (brk_…), если не указан — проверяются все подключённые счета',
+        },
+      },
+    },
+    async run({ period = 'yesterday', fromDate, toDate, accountId } = {}) {
+      let st = brokersState();
+      const targetAccs = (st.accounts || []).filter((a) => !accountId || a.id === accountId || a.accountId === accountId);
+      if (!targetAccs.length) {
+        return { result: { ошибка: 'Подключённые брокерские счета не найдены' }, summary: 'Счета не найдены', ok: false };
+      }
+      // Освежаем историю операций у брокера, если она ещё не загружалась или старше 2 минут
+      for (const a of targetAccs) {
+        if (a.broker === 'tbank' && a.hasToken && (!a.lastHistory?.at || Date.now() - a.lastHistory.at > 120000)) {
+          try { st = await fetchBrokerHistory(a.id); } catch { /* ignore */ }
+        }
+      }
+      const nowMskDate = new Date(Date.now() + MSK);
+      const todayIso = nowMskDate.toISOString().slice(0, 10);
+      const yesterdayIso = new Date(Date.now() + MSK - DAY).toISOString().slice(0, 10);
+
+      let startIso = yesterdayIso;
+      let endIso = yesterdayIso;
+      let periodLabel = `вчера (${yesterdayIso.split('-').reverse().join('.')})`;
+
+      if (fromDate || toDate) {
+        startIso = (fromDate || toDate).slice(0, 10);
+        endIso = (toDate || fromDate || todayIso).slice(0, 10);
+        periodLabel = startIso === endIso ? startIso.split('-').reverse().join('.') : `${startIso.split('-').reverse().join('.')} – ${endIso.split('-').reverse().join('.')}`;
+      } else if (period === 'today') {
+        startIso = todayIso;
+        endIso = todayIso;
+        periodLabel = `сегодня (${todayIso.split('-').reverse().join('.')})`;
+      } else if (period === 'week') {
+        startIso = new Date(Date.now() + MSK - 7 * DAY).toISOString().slice(0, 10);
+        endIso = todayIso;
+        periodLabel = `7 дней (${startIso.split('-').reverse().join('.')} – ${endIso.split('-').reverse().join('.')})`;
+      } else if (period === 'month') {
+        startIso = new Date(Date.now() + MSK - 30 * DAY).toISOString().slice(0, 10);
+        endIso = todayIso;
+        periodLabel = `30 дней (${startIso.split('-').reverse().join('.')} – ${endIso.split('-').reverse().join('.')})`;
+      }
+
+      const freshAccs = (st.accounts || []).filter((a) => !accountId || a.id === accountId || a.accountId === accountId);
+      const reports = freshAccs.map((a) => {
+        const allOps = a.lastHistory?.operations || [];
+        const opsInPeriod = allOps.filter((op) => {
+          if (!op.date) return false;
+          const opDayIso = new Date(op.date + MSK).toISOString().slice(0, 10);
+          return opDayIso >= startIso && opDayIso <= endIso;
+        }).sort((x, y) => (x.date || 0) - (y.date || 0));
+
+        let buyCount = 0, sellCount = 0, buySumRub = 0, sellSumRub = 0, feeSumRub = 0, divSumRub = 0;
+        const bySymbol = {};
+        for (const op of opsInPeriod) {
+          const pay = Number(op.paymentRub) || 0;
+          if (op.kind === 'buy') {
+            buyCount++;
+            buySumRub += Math.abs(pay);
+          } else if (op.kind === 'sell') {
+            sellCount++;
+            sellSumRub += Math.abs(pay);
+          } else if (op.kind === 'fee') {
+            feeSumRub += Math.abs(pay);
+          } else if (op.kind === 'div') {
+            divSumRub += pay;
+          }
+          if (op.symbol && (op.kind === 'buy' || op.kind === 'sell' || op.kind === 'fee')) {
+            if (!bySymbol[op.symbol]) {
+              bySymbol[op.symbol] = { тикер: op.symbol, название: op.name || op.symbol, куплено_шт: 0, сумма_покупок_руб: 0, продано_шт: 0, сумма_продаж_руб: 0, комиссия_руб: 0, финрезультат_закрытого_объёма_руб: 0 };
+            }
+            const s = bySymbol[op.symbol];
+            if (op.kind === 'buy') {
+              s.куплено_шт += op.qty || 0;
+              s.сумма_покупок_руб = round(s.сумма_покупок_руб + Math.abs(pay), 2);
+            } else if (op.kind === 'sell') {
+              s.продано_шт += op.qty || 0;
+              s.сумма_продаж_руб = round(s.сумма_продаж_руб + Math.abs(pay), 2);
+            } else if (op.kind === 'fee') {
+              s.комиссия_руб = round(s.комиссия_руб + Math.abs(pay), 2);
+            }
+          }
+        }
+        let totalClosedNetPnlRub = 0;
+        for (const s of Object.values(bySymbol)) {
+          const matchedQ = Math.min(s.куплено_шт, s.продано_шт);
+          if (matchedQ > 0) {
+            const avgBuy = s.сумма_покупок_руб / s.куплено_шт;
+            const avgSell = s.сумма_продаж_руб / s.продано_шт;
+            const grossPnl = matchedQ * (avgSell - avgBuy);
+            const feeShare = s.комиссия_руб * ((2 * matchedQ) / (s.куплено_шт + s.продано_шт));
+            s.финрезультат_закрытого_объёма_руб = round(grossPnl - feeShare, 2);
+            totalClosedNetPnlRub = round(totalClosedNetPnlRub + s.финрезультат_закрытого_объёма_руб, 2);
+          }
+        }
+
+        // Если за выбранный день сделок не было, подскажем ближайшую дату, когда сделки были
+        let prevActiveDay = null;
+        if (!opsInPeriod.length && allOps.length) {
+          const prevOp = allOps.find((op) => op.date && new Date(op.date + MSK).toISOString().slice(0, 10) < startIso);
+          if (prevOp) prevActiveDay = fmtDayMsk(prevOp.date);
+        }
+
+        return {
+          счёт: a.name,
+          брокер: a.broker,
+          период_мск: periodLabel,
+          всего_операций_за_период: opsInPeriod.length,
+          сделок_покупки: buyCount,
+          сделок_продажи: sellCount,
+          оборот_покупок_руб: round(buySumRub, 2),
+          оборот_продаж_руб: round(sellSumRub, 2),
+          уплачено_комиссий_руб: round(feeSumRub, 2),
+          чистый_финрезультат_закрытых_сделок_руб: totalClosedNetPnlRub,
+          ...(divSumRub ? { дивиденды_купоны_руб: round(divSumRub, 2) } : {}),
+          сводка_по_бумагам: Object.values(bySymbol),
+          хронология_операций: opsInPeriod.slice(-80).map((op) => ({
+            время_мск: fmtBarMsk(op.date),
+            тип: op.kindLabel,
+            тикер: op.symbol || '—',
+            название: op.name || '',
+            кол_во_шт: op.qty || 0,
+            цена: op.price || 0,
+            сумма_руб: op.paymentRub,
+          })),
+          ...(prevActiveDay ? { подсказка: `За период ${periodLabel} операций не было; ближайший предыдущий день со сделками: ${prevActiveDay}` } : {}),
+        };
+      });
+
+      const totalTrades = reports.reduce((s, r) => s + r.сделок_покупки + r.сделок_продажи, 0);
+      return {
+        result: {
+          текущее_время_мск: fmtBarMsk(Date.now()),
+          выбранный_период: periodLabel,
+          отчёты_по_счетам: reports,
+        },
+        summary: `История торгов за ${periodLabel}: сделок ${totalTrades}`,
+      };
+    },
+  },
+
+  model_forecast: {
+    kind: 'read',
+    label: 'Смотрит прогноз на ближайшие часы',
+    description: 'Живой прогноз модели по ~100 акциям Мосбиржи: какие акции ожидаются сильнее или слабее рынка в ближайшие 1,5–3,5 часа, пороги входа в лонг и шорт, живой импульс текущей свечи и цепочка влияния соседей по карте рынка.',
+    parameters: { type: 'object', properties: { top: { type: 'number', description: 'сколько акций показать, по умолчанию 10' } } },
+    async run({ top = 10 }) {
+      const r = await forecastNow(getSettings());
+      const buyThr = r.buyThresholdPct ?? r.thresholdPct;
+      const shortThr = r.shortThresholdPct ?? r.thresholdPct;
+      const pick = (x) => {
+        const buyBlockedByDip = !x.signal && x.liquid && x.expectedPct >= buyThr && (x.lastMovePct ?? 0) < -0.35;
+        const shortBlockedBySpike = !x.shortSignal && !x.shortBlockedByBroker && x.liquid && x.expectedPct <= -shortThr && (x.lastMovePct ?? 0) > 0.35;
+        return {
+          акция: x.symbol,
+          название: x.name,
+          цена_руб: x.price,
+          ожидание_проц: x.expectedPct,
+          импульс_текущей_свечи_проц: x.lastMovePct ?? 0,
+          динамика_проц: x.deltaPct || 0,
+          сигнал_покупки: !!x.signal,
+          ...(buyBlockedByDip ? { покупка_заблокирована: `сейчас бумага падает на текущей свече (${x.lastMovePct}%), сработала защита от ловли падающего ножа` } : {}),
+          ...(x.shortSignal !== undefined ? { сигнал_шорта: !!x.shortSignal } : {}),
+          ...(shortBlockedBySpike ? { шорт_заблокирован: `сейчас бумага резко растёт на текущей свече (+${x.lastMovePct}%), сработала защита от шорт-сквиза` } : {}),
+          ...(x.shortBlockedByBroker ? { шорт_запрещён_брокером: true } : {}),
+          ликвидна: x.liquid,
+          влияют_соседи: (x.influences || []).map((n) => `${n.symbol} (${n.contribPct > 0 ? '+' : ''}${n.contribPct}%, близость ${n.closeness})`),
+        };
+      };
+      return {
+        result: {
+          текущее_время_мск: fmtBarMsk(Date.now()),
+          свеча: r.bar,
+          горизонт_часов: r.horizon,
+          порог_покупки_проц: buyThr,
+          порог_шорта_проц: shortThr,
+          тренд_индекса: r.marketDown ? 'падающий (облегчён шорт, ужесточён лонг)' : 'растущий (стандартный лонг, ужесточён шорт)',
+          сильнее_рынка: r.rows.slice(0, top).map(pick),
+          слабее_рынка: r.rows.slice(-Math.min(6, top)).reverse().map(pick),
+        },
+        summary: `Прогноз на свече ${r.bar}: сигналов покупки ${r.rows.filter((x) => x.signal).length}, шорта ${r.rows.filter((x) => x.shortSignal).length}`,
+      };
+    },
+  },
+
+  get_news: {
+    kind: 'read',
+    label: 'Смотрит свежие новости',
+    description: 'Свежие новости и раскрытия эмитентов Мосбиржи: каких акций касаются, тон −1…+1 (негатив/позитив), важность 0…1 и краткая суть.',
+    parameters: {
+      type: 'object',
+      properties: {
+        symbol: { type: 'string', description: 'тикер, например SBER; без него — все важные новости по рынку' },
+        hours: { type: 'number', description: 'за сколько часов смотреть, по умолчанию 24' },
+      },
+    },
+    async run({ symbol, hours = 24 }) {
+      const items = listNews({ symbol, hours, limit: 25 });
+      if (!items.length) return { result: { новостей: 'нет' }, summary: `Новостей ${symbol ? `по ${symbol}` : ''} за последние ${hours} ч нет` };
+      const nowTs = Date.now();
+      const todayIso = new Date(nowTs + MSK).toISOString().slice(0, 10);
+      const yesterdayIso = new Date(nowTs + MSK - DAY).toISOString().slice(0, 10);
+      return {
+        result: {
+          текущее_время_мск: fmtBarMsk(nowTs),
+          новости: items.map((n) => {
+            const dIso = new Date(n.ts + MSK).toISOString().slice(0, 10);
+            const dayTag = dIso === todayIso ? 'сегодня' : dIso === yesterdayIso ? 'вчера' : fmtDayMsk(n.ts);
+            const ageHours = round(Math.max(0, (nowTs - n.ts) / 3600000), 1);
+            return {
+              время_мск: fmtBarMsk(n.ts),
+              день: dayTag,
+              давность_часов: ageHours,
+              источник: n.src,
+              ...(n.symbols.length ? { акции: n.symbols.map((s) => `${s.symbol} (тон ${s.tone ?? '—'})`) } : {}),
+              ...(n.imp !== null ? { важность: n.imp } : {}),
+              суть: n.gist || n.title,
+              ссылка: n.link,
+            };
+          }),
+        },
+        summary: `Новости за ${hours} ч: ${items.length}${symbol ? ` по ${symbol}` : ''}`,
+      };
+    },
+  },
+
+  market_neighbors: {
+    kind: 'read',
+    label: 'Смотрит соседей акции на карте рынка',
+    description: 'Ближайшие соседи акции на спектральной карте рынка (какие бумаги движутся синхронно и передают импульс).',
+    parameters: { type: 'object', properties: { symbol: { type: 'string' } }, required: ['symbol'] },
+    async run({ symbol }) {
+      const symUp = String(symbol || '').toUpperCase().trim();
+      const fc = await forecastNow(getSettings()).catch(() => null);
+      const row = fc?.rows?.find((r) => r.symbol === symUp);
+      if (row?.influences?.length) {
+        return {
+          result: { акция: symUp, название: row.name, цена_руб: row.price, ожидание_проц: row.expectedPct, ближайшие_влияющие_соседи: row.influences },
+          summary: `Соседи ${symUp}: ${row.influences.slice(0, 4).map((x) => x.symbol).join(', ')}`,
+        };
+      }
+      const run = listRuns().find((r) => r.mode === 'model' && r.status === 'done');
+      const ex = run && getRun(run.id)?.extra;
+      if (!ex) return { result: { ошибка: 'нет данных по соседям' }, summary: 'Нет данных по соседям', ok: false };
+      const i = ex.symbols.indexOf(symUp);
+      if (i < 0) return { result: { ошибка: `${symUp} нет в словаре модели` }, summary: `${symUp} нет в словаре`, ok: false };
+      return {
+        result: { акция: ex.symbols[i], соседи: ex.neighbors[i].map(([k, c]) => ({ акция: ex.symbols[k], близость: c })) },
+        summary: `Соседи ${ex.symbols[i]}: ${ex.neighbors[i].slice(0, 4).map(([k]) => ex.symbols[k]).join(', ')}`,
+      };
+    },
+  },
+
+  get_settings: {
+    kind: 'read',
+    label: 'Смотрит настройки издержек и фильтра новостей',
+    description: 'Текущие настройки комиссий брокера, проскальзывания, ставки за шорт и новостного фильтра.',
+    parameters: { type: 'object', properties: {} },
+    async run() {
+      const s = getSettings();
+      const visible = PARAMS.filter((p) => !p.hidden);
+      return {
+        result: Object.fromEntries(visible.map((p) => [p.key, { значение: s[p.key], что_это: p.label, пояснение: p.hint }])),
+        summary: 'Прочитал настройки издержек и новостей',
+      };
+    },
+  },
+
+  set_settings: {
+    kind: 'write',
+    confirmAlways: true,
+    label: 'Меняет настройки',
+    description: 'Предложить изменение настроек в разделе «Издержки и новости» (с подтверждением пользователя кнопкой).',
+    parameters: { type: 'object', properties: { changes: changesSchema, reason: { type: 'string', description: 'пояснение для пользователя' } }, required: ['changes', 'reason'] },
+    preview(args) {
+      const { values, errors } = checkChanges(args.changes);
+      return `${args.reason || ''}\nИзменения: ${describeChanges(values)}${errors.length ? `\nОшибки: ${errors.join('; ')}` : ''}`;
+    },
+    async run(args) {
+      const { values, errors } = checkChanges(args.changes);
+      const r = updateSettings(values, { source: 'ai', reason: args.reason });
+      const all = [...errors, ...r.errors];
+      return {
+        result: { изменено: r.changed, ошибки: all.length ? all : undefined },
+        summary: Object.keys(r.changed).length ? `Настройки изменены: ${describeChanges(Object.fromEntries(Object.entries(r.changed).map(([k, v]) => [k, v.стало])))}` : `Настройки не изменились${all.length ? `: ${all.join('; ')}` : ''}`,
+        ok: !all.length,
+      };
+    },
+  },
+
+  broker_onboarding_guide: {
+    kind: 'read',
+    label: 'Справка по открытию и подключению брокерского счёта',
+    description: 'Получить подробную пошаговую инструкцию по открытию брокерского счёта, включению маржинальной торговли, выпуску API-токена и список уже подключённых счетов пользователя.',
+    parameters: {
+      type: 'object',
+      properties: {
+        broker: {
+          type: 'string',
+          enum: ['tbank', 'finam', 'bcs', 'alor', 'cifra', 'iticapital'],
+          description: 'код выбранного брокера',
+        },
+      },
+    },
+    async run({ broker = 'tbank' } = {}) {
+      const st = brokersState();
+      const meta = BROKER_META.find((b) => b.id === broker) || BROKER_META[0];
+      const guides = {
+        tbank: {
+          openAccountUrl: 'https://www.tbank.ru/invest/',
+          tokenUrl: 'https://www.tbank.ru/invest/settings/',
+          accountTypeAdvice: 'Открывайте обычный «Брокерский счёт» (не Инвесткопилку и не счёт автоследования; для шортов на тарифах Профи/VIP нужен обычный брокерский счёт с включённой маржинальной торговлей).',
+          stepsToGetToken: [
+            '1. Откройте веб-кабинет Т-Инвестиций: https://www.tbank.ru/invest/settings/ (раздел «Токены T-Invest API»).',
+            '2. Нажмите «Выпустить токен» → выберите «Полный доступ» (для выставления заявок) и «Все счета».',
+            '3. Скопируйте токен (начинается с t.…) и пришлите его сюда в чат или вставьте в форму — я сам найду все ваши субсчета через discover_broker_accounts и подключу нужный счёт.',
+            '4. Чтобы стратегия зарабатывала и на падении акций (шорт), в мобильном приложении Т-Инвестиций зайдите в настройки выбранного счёта (шестерёнка вверху справа) и включите «Маржинальная торговля».',
+          ],
+        },
+        finam: {
+          openAccountUrl: 'https://www.finam.ru/',
+          tokenUrl: 'https://edox.finam.ru/',
+          accountTypeAdvice: 'Единый брокерский счёт Мосбиржи (КлФ / ЕДП).',
+          stepsToGetToken: [
+            '1. В кабинете клиента Финам (edox.finam.ru) откройте «Торговля → Токены доступа (Finam Trade API)».',
+            '2. Выпустите новый токен (начинается на CA…) и скопируйте ваш торговый код клиента ClientId (например 123456R).',
+            '3. Пришлите токен и ClientId или нажмите кнопку подтверждения — я подключу счёт через connect_broker_account.',
+          ],
+        },
+        bcs: {
+          openAccountUrl: 'https://bcs.ru/',
+          tokenUrl: 'https://my.broker.ru/',
+          accountTypeAdvice: 'Обычный брокерский счёт БКС Мир инвестиций с доступом к Мосбирже TQBR.',
+          stepsToGetToken: [
+            '1. В веб-терминале «БКС Мир инвестиций» откройте Настройки профиля → «Торговый API (BCS Trade API)».',
+            '2. Выпустите Refresh-токен с правом «Чтение и торговля» (trade-api-write).',
+            '3. Передайте Refresh-токен — я создам и синхронизирую счёт.',
+          ],
+        },
+        alor: {
+          openAccountUrl: 'https://www.alorbroker.ru/',
+          tokenUrl: 'https://alor.dev/',
+          accountTypeAdvice: 'Фондовый счёт Мосбиржи (портфель с литерой D, например D12345).',
+          stepsToGetToken: [
+            '1. Авторизуйтесь под брокерским аккаунтом на портале разработчика https://alor.dev (или в кабинете my.alor.ru → OpenAPI).',
+            '2. Выпустите Refresh Token для боевого контура и укажите номер портфеля D…',
+          ],
+        },
+        cifra: {
+          openAccountUrl: 'https://cifra-broker.ru/',
+          tokenUrl: 'https://tradernet.ru/',
+          accountTypeAdvice: 'Брокерский счёт Tradernet (Мосбиржа).',
+          stepsToGetToken: [
+            '1. В кабинете tradernet.ru откройте Настройки профиля → «API ключи».',
+            '2. Сгенерируйте пару ключей PublicKey и SecretKey и передайте их через двоеточие: PublicKey:SecretKey.',
+          ],
+        },
+        iticapital: {
+          openAccountUrl: 'https://iticapital.ru/',
+          tokenUrl: 'https://iticapital.ru/',
+          accountTypeAdvice: 'Фондовый портфель Мосбиржи вида BP12345.',
+          stepsToGetToken: [
+            '1. В личном кабинете ITI Capital откройте «Торговые системы → OpenAPI» и выпустите Refresh Token.',
+            '2. Укажите Refresh-токен и код портфеля BP…',
+          ],
+        },
+        sber: {
+          openAccountUrl: 'https://www.sberbank.ru/ru/person/investments',
+          accountTypeAdvice: 'Обычный брокерский счёт СберИнвестиций.',
+          stepsToGetToken: [
+            'У СберИнвестиций нет облачного REST-токена для физлиц, поэтому счёт подключается БЕЗ токена в режиме «Подтверждение заявок» (или через адрес локального HTTP-шлюза QUIK).',
+            'Достаточно указать желаемый лимит суммы на стратегию (например 100 000 ₽) и номер счёта — я сразу создам счёт в платформе через connect_broker_account и рассчитаю первые заявки в лотах Мосбиржи!',
+          ],
+        },
+        vtb: {
+          openAccountUrl: 'https://broker.vtb.ru/',
+          accountTypeAdvice: 'Обычный брокерский счёт ВТБ Мои Инвестиции.',
+          stepsToGetToken: [
+            'У ВТБ Мои Инвестиции нет облачного REST-токена для физлиц — счёт подключается без токена в режиме «Подтверждение заявок» (с уведомлениями в Telegram/MAX и учётом портфеля) или через адрес моста QUIK.',
+          ],
+        },
+        alfa: {
+          openAccountUrl: 'https://alfabank.ru/make-money/investments/',
+          accountTypeAdvice: 'Обычный брокерский счёт Альфа-Инвестиций.',
+          stepsToGetToken: [
+            'У Альфа-Инвестиций нет облачного REST-токена для физлиц — счёт подключается без токена в режиме «Подтверждение заявок» или через адрес моста QUIK.',
+          ],
+        },
+      };
+      return {
+        result: {
+          брокер: meta,
+          инструкция: guides[broker] || guides.tbank,
+          уже_подключённые_счета: st.accounts.map((a) => ({
+            id: a.id,
+            название: a.name,
+            брокер: a.broker,
+            субсчёт: a.accountId,
+            режим: a.mode,
+            режим_старого_портфеля: a.legacyMode || 'isolate',
+            лимит_руб: a.maxCapitalRub,
+            баланс_руб: a.lastSync?.totalRub ?? null,
+            маржиналка: a.lastSync?.marginEnabled ?? null,
+          })),
+        },
+        summary: `Загрузил инструкцию по подключению брокера «${meta.name}»`,
+      };
+    },
+  },
+
+  discover_broker_accounts: {
+    kind: 'read',
+    label: 'Ищет субсчета брокера по сохранённому токену',
+    description: 'Найти все открытые брокерские субсчета пользователя в Т-Банке по токену УЖЕ СОХРАНЁННОГО в платформе счёта (id из get_brokers_status): баланс, маржинальная торговля, отсутствие автоследования. Токен никогда не передаётся через чат: если счёта с токеном ещё нет, попроси пользователя вставить токен в форму «+ Добавить счёт» (поле «Токен») и сохранить счёт.',
+    parameters: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'ID сохранённого счёта Т-Банка в платформе (brk_…)' },
+        sandbox: { type: 'boolean', description: 'Контур песочницы (по умолчанию false)' },
+      },
+      required: ['id'],
+    },
+    async run({ id, sandbox = false }) {
+      const r = await discoverBrokerAccounts({ broker: 'tbank', id, sandbox });
+      return {
+        result: {
+          найдено_счетов: r.accounts.length,
+          счета: r.accounts.map((a) => ({
+            accountId: a.id,
+            название: a.name,
+            тип: a.type,
+            доступ: a.access,
+            баланс_руб: a.totalRub,
+            свободные_рубли: a.cashRub,
+            позиций: a.positionsCount,
+            маржинальная_торговля: a.marginEnabled ? 'включена (шорты доступны)' : 'выключена (только в рост)',
+            автоследование: a.autoFollowDetected ? 'ОБНАРУЖЕНО (подключать запрещено Офертой)' : 'нет (можно подключать)',
+            пригодность: a.eligibleForTrading ? 'подходит для торговли' : 'только просмотр / копилка',
+          })),
+        },
+        summary: `Найдено счетов в Т-Банке: ${r.accounts.length}`,
+      };
+    },
+  },
+
+  connect_broker_account: {
+    kind: 'write',
+    confirmAlways: true,
+    label: 'Подключает или настраивает брокерский счёт',
+    description: 'Добавить или обновить настройки брокерского счёта в платформе «НейроАльфа», сразу выполнить синхронизацию портфеля и рассчитать пакет заявок. Токен брокера этим инструментом НЕ задаётся и в чат не запрашивается — пользователь вставляет его сам в форму счёта. Режим «auto» доступен только для Т-Банка.',
+    parameters: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'ID существующего счёта в платформе (если обновляем существующий счёт)' },
+        broker: {
+          type: 'string',
+          enum: ['tbank', 'finam', 'bcs', 'alor', 'cifra', 'iticapital'],
+          description: 'Код брокера (полная поддержка — tbank; остальные в бете, только с подтверждением заявок)',
+        },
+        name: { type: 'string', description: 'Понятное название счёта (например «Т-Банк основной»)' },
+        accountId: { type: 'string', description: 'ID субсчёта / ClientId / номер портфеля' },
+        mode: { type: 'string', enum: ['readonly', 'confirm', 'auto'], description: 'Режим работы: confirm (подтверждение заявок), auto (автомат, только Т-Банк) или readonly' },
+        legacyMode: { type: 'string', enum: ['isolate', 'smooth', 'takeover'], description: 'Режим для старых бумаг на счёте: isolate (не трогать старые бумаги), smooth (плавный переход) или takeover (полное управление)' },
+        maxCapitalRub: { type: 'number', description: 'Лимит суммы на стратегию в рублях (например 100000 или 1000000)' },
+        maxDailyDrawdownPct: { type: 'number', description: 'Дневной стоп по просадке в % (по умолчанию 3)' },
+        limitOffsetPct: { type: 'number', description: 'Защитный отступ лимитной заявки в % (по умолчанию 0.1)' },
+        sandbox: { type: 'boolean', description: 'Тестовый режим — песочница брокера (по умолчанию false)' },
+      },
+      required: ['broker'],
+    },
+    preview(args) {
+      const meta = BROKER_META.find((b) => b.id === args.broker);
+      const modeLbl = { readonly: 'Только чтение', confirm: 'Подтверждение заявок', auto: 'Автомат' }[args.mode || 'confirm'] || 'Подтверждение заявок';
+      const legLbl = { isolate: 'Изолированный карман', smooth: 'Плавный переход', takeover: 'Полное управление' }[args.legacyMode || 'isolate'] || 'Изолированный карман';
+      return `Брокер: ${meta?.name || args.broker}${args.name ? ` («${args.name}»)` : ''}${args.accountId ? ` · счёт ${args.accountId}` : ''} · режим «${modeLbl}» · старый портфель: «${legLbl}» · лимит ${args.maxCapitalRub || 100000} ₽`;
+    },
+    async run(args) {
+      const beforeIds = new Set(brokersState().accounts.map((a) => a.id));
+      const st = saveBrokerAccount({
+        id: args.id,
+        broker: args.broker,
+        name: args.name,
+        accountId: args.accountId,
+        mode: args.mode || 'confirm',
+        legacyMode: args.legacyMode || 'isolate',
+        maxCapitalRub: args.maxCapitalRub || 100000,
+        maxDailyDrawdownPct: args.maxDailyDrawdownPct ?? 3,
+        limitOffsetPct: args.limitOffsetPct ?? 0.1,
+        sandbox: Boolean(args.sandbox),
+      });
+      const created = args.id ? st.accounts.find((a) => a.id === args.id) : st.accounts.find((a) => !beforeIds.has(a.id)) || st.accounts[st.accounts.length - 1];
+      let syncRes = null;
+      if (created && created.hasToken) {
+        try {
+          const synced = await syncBrokerAccount(created.id);
+          await prepareBrokerOrders(created.id).catch(() => {});
+          const accNow = synced.accounts.find((a) => a.id === created.id);
+          syncRes = {
+            синхронизировано: Boolean(accNow?.lastSync?.ok),
+            ошибка_синхронизации: accNow?.lastSync?.error || null,
+            баланс_руб: accNow?.lastSync?.totalRub ?? null,
+            свободные_рубли: accNow?.lastSync?.cashRub ?? null,
+            маржинальная_торговля: accNow?.lastSync?.marginEnabled ?? null,
+            подготовлено_заявок: accNow?.pendingBatch?.orders?.length ?? 0,
+          };
+        } catch (e) {
+          syncRes = { синхронизировано: false, ошибка_синхронизации: e.message };
+        }
+      }
+      return {
+        result: {
+          ok: true,
+          счёт: created ? { id: created.id, название: created.name, брокер: created.broker, субсчёт: created.accountId, режим: created.mode, лимит_руб: created.maxCapitalRub } : null,
+          статус_подключения: syncRes,
+        },
+        summary: `Подключён брокерский счёт «${created?.name || args.broker}»${syncRes?.баланс_руб !== null && syncRes?.баланс_руб !== undefined ? ` (баланс ${syncRes.баланс_руб} ₽)` : ''}`,
+      };
+    },
+  },
+
+  list_runs: {
+    kind: 'read',
+    label: 'Смотрит список проведённых исследований',
+    description: 'Посмотреть список завершённых исторических исследований модели.',
+    parameters: { type: 'object', properties: { limit: { type: 'number', description: 'сколько последних, по умолчанию 6' } } },
+    async run({ limit = 6 }) {
+      return { result: recentRuns(Math.min(20, limit)), summary: 'Просмотрел список исследований' };
+    },
+  },
+
+  analyze_run: {
+    kind: 'read',
+    label: 'Разбирает результаты исследования',
+    description: 'Подробный разбор завершённого исследования по его номеру: вклад акций, часов входа, сроков удержания и голов внимания.',
+    parameters: { type: 'object', properties: { run_id: { type: 'number', description: 'номер исследования' } }, required: ['run_id'] },
+    async run({ run_id }) {
+      const r = analyzeRun(Number(run_id));
+      return { result: r, summary: r.ошибка || `Разобрал исследование №${run_id}` };
+    },
+  },
+
+  compare_runs: {
+    kind: 'read',
+    label: 'Сравнивает два исследования',
+    description: 'Сравнить два готовых исследования по их номерам.',
+    parameters: { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } }, required: ['a', 'b'] },
+    async run({ a, b }) {
+      return { result: compareRuns(Number(a), Number(b)), summary: `Сравнил исследования №${a} и №${b}` };
+    },
+  },
+};
+
+export const MODES = {
+  discuss: { label: 'Консультант', allowed: (t) => t.kind === 'read' },
+  advisor: { label: 'Консультант', allowed: () => true, confirm: (t) => t.kind !== 'read' },
+  autopilot: { label: 'Консультант', allowed: () => true, confirm: (t) => t.kind !== 'read' },
+  review: { label: 'Разбор', allowed: (t) => t.kind === 'read' },
+};
+
+export function toolSchemas(mode = 'advisor') {
+  const m = MODES[mode] || MODES.advisor;
+  return Object.entries(TOOLS)
+    .filter(([, t]) => m.allowed(t))
+    .map(([name, t]) => ({ type: 'function', function: { name, description: t.description, parameters: t.parameters } }));
+}