Каталог инструментов

Каталог открытый: ни один инструмент не обязателен. Бизнес реализует те семейства, которые у него есть, и свободно добавляет собственные инструменты без префикса платформы.

Инструмент	Семейство	Доступ	Списковый	Назначение
`norm_meetings_list`	meetings	чтение	да	Встречи компании за интервал дат.
`norm_meeting_get`	meetings	чтение	нет	Сводка одной встречи по id: резюме, поручения, темы, ключевые вопросы, участники и повестка — этого достаточно для протокола и задач.
`norm_meeting_transcript`	meetings	чтение	нет	Сырая расшифровка встречи окном — дорогой вызов, берите только если сводки не хватило.
`norm_protocol_types`	protocols	чтение	нет	Типы встреч компании и подсказки к ним — весь справочник одним ответом, спрашивайте один раз за прогон.
`norm_protocols_list`	protocols	чтение	да	Протоколы компании страницами, от свежих к старым по дате встречи.
`norm_protocol_get`	protocols	чтение	нет	Протокол одной встречи по meeting_id целиком: ядро, тело, дополнительные поля, ссылка.
`norm_protocol_upsert`	protocols	запись	нет	Создать или переписать протокол встречи: ядро полей плюс тело в markdown.
`norm_org_units`	people	чтение	нет	Дерево подразделений компании целиком.
`norm_people_list`	people	чтение	да	Сотрудники компании страницами.
`norm_roles_list`	people	чтение	да	Роли компании страницами: то, чем занимаются её люди.
`norm_person_get`	people	чтение	нет	Карточка одного сотрудника целиком.
`norm_person_upsert`	people	запись	нет	Создать или обновить карточку сотрудника.
`norm_record_targets`	records	чтение	нет	Куда вообще можно писать записи: ярлыки целей, названия для человека и вид карточки.
`norm_record_schema`	records	чтение	нет	Из чего состоит карточка целевой записи: поля, их типы, что обязательно и какие значения допустимы.
`norm_record_find`	records	чтение	нет	Есть ли уже записи по этим ключам — спрашивайте пакетом до 200 ключей за вызов, а не по одной.
`norm_record_hint`	records	чтение	нет	Подсказка под ОДИН выбранный вариант поля: текст, который компания просит учесть, когда значение поля именно такое.
`norm_record_upsert`	records	запись	нет	Создать или переписать запись в системе компании: поля карточки плюс тело в markdown.
`norm_notify`	notify	запись	нет	Уведомить человека о том, что требует его внимания: о незаполненном, о неуверенно определённом, о готовности.
`norm_knowledge_search`	knowledge	чтение	да	Поиск по документам компании: протоколы, заметки, регламенты, записи систем учёта.
`norm_sources_status`	sources	чтение	нет	Какие системы компании подключены, что они питают и когда синхронизировались в последний раз.
`norm_sources_refresh`	sources	запись	нет	Запустить синхронизацию источников сейчас, перед ответом на свежих данных.

Поле	Обязательно	Тип
`access`	да	`read` \| `write`
`description`	да	string
`family`	да	`meetings` \| `protocols` \| `people` \| `records` \| `notify` \| `knowledge` \| `sources`
`input_schema`	да	object
`list`	да	boolean
`name`	да	string
`output_schema`	да	object
`replaced_by`	нет	string
`success_required`	нет	список string
`sunset`	нет	string (date)
`versions`	да	список integer

Ключ записи

Формат ключа контракт не предписывает. Рекомендация: <вид цели>:<идентификатор в источнике>, например meeting_protocol:01K9F2QH7T8ZRC4M0X5B2VNJ3D. Ключ непрозрачен для реализации и сравнивается побайтно.

Форма значения поля записи

Значение в fields[].value схемой не типизируется: форма зависит от типа поля, а объединение разных форм непереносимо. Правило по типу поля: text и url — строка; date — объект { start, end? }; person — список идентификаторов людей; choice_one — идентификатор варианта; choice_many — список идентификаторов.