@itphx/synth-shared 0.13.4 → 0.13.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/dist/config/defaults.js +102 -3
  2. package/dist/config/env-overrides.d.ts +39 -4
  3. package/dist/config/env-overrides.js +174 -4
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +3 -0
  9. package/dist/config/index.js +3 -0
  10. package/dist/config/loader.d.ts +8 -0
  11. package/dist/config/loader.js +6 -1
  12. package/dist/config/redact.d.ts +22 -0
  13. package/dist/config/redact.js +53 -0
  14. package/dist/config/security.d.ts +77 -0
  15. package/dist/config/security.js +116 -0
  16. package/dist/config/tls.d.ts +7 -4
  17. package/dist/config/tls.js +10 -23
  18. package/dist/config/types.d.ts +568 -38
  19. package/dist/config/types.js +390 -33
  20. package/dist/i18n/index.d.ts +1 -1
  21. package/dist/i18n/index.js +325 -13
  22. package/dist/index.d.ts +7 -6
  23. package/dist/index.js +17 -4
  24. package/dist/model-metadata.d.ts +10 -0
  25. package/dist/model-metadata.js +10 -0
  26. package/dist/schemas/index.d.ts +444 -30
  27. package/dist/schemas/index.js +354 -17
  28. package/dist/skills/frontmatter.js +1 -1
  29. package/dist/types/agent.d.ts +29 -1
  30. package/dist/types/authority.d.ts +10 -0
  31. package/dist/types/authority.js +8 -0
  32. package/dist/types/bus-events.d.ts +88 -2
  33. package/dist/types/catalog.d.ts +1 -1
  34. package/dist/types/catalog.js +1 -1
  35. package/dist/types/command-audit.d.ts +91 -0
  36. package/dist/types/command-audit.js +44 -0
  37. package/dist/types/commands.d.ts +29 -11
  38. package/dist/types/commands.js +2 -2
  39. package/dist/types/egress.d.ts +18 -3
  40. package/dist/types/egress.js +18 -3
  41. package/dist/types/events.d.ts +23 -2
  42. package/dist/types/execution.d.ts +424 -0
  43. package/dist/types/execution.js +355 -0
  44. package/dist/types/file-kind.d.ts +3 -2
  45. package/dist/types/file-kind.js +11 -2
  46. package/dist/types/git.d.ts +131 -0
  47. package/dist/types/git.js +101 -1
  48. package/dist/types/host-pattern.d.ts +41 -0
  49. package/dist/types/host-pattern.js +143 -0
  50. package/dist/types/index.d.ts +8 -0
  51. package/dist/types/index.js +25 -3
  52. package/dist/types/maintenance.d.ts +1 -1
  53. package/dist/types/mcp.d.ts +90 -0
  54. package/dist/types/mcp.js +11 -0
  55. package/dist/types/mentions.d.ts +96 -0
  56. package/dist/types/mentions.js +9 -0
  57. package/dist/types/message-stream.d.ts +41 -0
  58. package/dist/types/message.d.ts +24 -1
  59. package/dist/types/message.js +13 -0
  60. package/dist/types/pack.d.ts +21 -21
  61. package/dist/types/pack.js +4 -4
  62. package/dist/types/permission.d.ts +20 -3
  63. package/dist/types/pipeline.d.ts +2 -2
  64. package/dist/types/plugin-protocol.d.ts +203 -4
  65. package/dist/types/plugin-protocol.js +77 -4
  66. package/dist/types/project-access.d.ts +94 -0
  67. package/dist/types/project-access.js +140 -0
  68. package/dist/types/project.d.ts +89 -2
  69. package/dist/types/project.js +36 -0
  70. package/dist/types/prompt.d.ts +4 -2
  71. package/dist/types/schedules.d.ts +49 -3
  72. package/dist/types/schedules.js +50 -1
  73. package/dist/types/scripts.d.ts +98 -0
  74. package/dist/types/scripts.js +14 -0
  75. package/dist/types/service-keys.d.ts +16 -3
  76. package/dist/types/service-keys.js +19 -1
  77. package/dist/types/session.d.ts +68 -3
  78. package/dist/types/skills.d.ts +21 -11
  79. package/dist/types/skills.js +6 -6
  80. package/dist/types/timers.d.ts +402 -0
  81. package/dist/types/timers.js +166 -0
  82. package/dist/types/tools.d.ts +160 -1
  83. package/dist/types/tools.js +70 -0
  84. package/dist/types/user.d.ts +24 -0
  85. package/dist/types/worktree.d.ts +1 -1
  86. package/dist/utils/index.js +1 -1
  87. package/dist/version.d.ts +1 -1
  88. package/dist/version.js +1 -1
  89. package/package.json +3 -2
@@ -6,4 +6,53 @@
6
6
  * маршрутизацию в сессию выполняет `EventRouter` (seam — `RouteRuleProvider`).
7
7
  * Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
8
8
  */
9
- export {};
9
+ /**
10
+ * PROP-141: код «проект расписания не определён».
11
+ *
12
+ * Запись без проекта **не теряется** — она остаётся в реестре, но
13
+ * отключается и помечается этой строкой в `lastError` (не срабатывает).
14
+ */
15
+ export const SCHEDULE_PROJECT_REQUIRED_ERROR = 'project_required';
16
+ /**
17
+ * PROP-141: проект расписания, выводимый **из цели** (без обращения к
18
+ * хранилищу).
19
+ *
20
+ * - `pipeline` → `target.projectId` (проект-владелец пайплайна);
21
+ * - `ephemeral` → `target.project`;
22
+ * - `bound`/`queue` → `undefined`: проект берётся у сессии-цели, а её
23
+ * разрешает резолвер «сессия → проект» (задаёт composition root).
24
+ */
25
+ export function deriveScheduleProjectId(target) {
26
+ switch (target.mode) {
27
+ case 'pipeline':
28
+ return target.projectId || undefined;
29
+ case 'ephemeral':
30
+ return target.project || undefined;
31
+ case 'bound':
32
+ case 'queue':
33
+ return undefined;
34
+ }
35
+ }
36
+ /**
37
+ * PROP-141: привести запись расписания к контракту «проект обязателен».
38
+ *
39
+ * Чистая функция (общий контракт для файлового/в-памяти/PG-сторов):
40
+ * - проект уже есть — запись не меняется;
41
+ * - проект выводится из цели (`pipeline`/`ephemeral`) — проставляется;
42
+ * - вывести нельзя (`bound`/`queue` без резолвера «сессия → проект») — запись
43
+ * **не теряется**: она отключается и помечается `project_required`
44
+ * (не срабатывает).
45
+ */
46
+ export function normalizeScheduleProject(schedule) {
47
+ if (schedule.projectId)
48
+ return schedule;
49
+ const derived = deriveScheduleProjectId(schedule.target);
50
+ if (derived)
51
+ return { ...schedule, projectId: derived };
52
+ return {
53
+ ...schedule,
54
+ projectId: '',
55
+ enabled: false,
56
+ lastError: SCHEDULE_PROJECT_REQUIRED_ERROR,
57
+ };
58
+ }
@@ -0,0 +1,98 @@
1
+ /**
2
+ * ADR-126 §5: скрипты проекта (`!`-запуск) — контракты.
3
+ *
4
+ * Скрипт — это **декларация** (markdown + frontmatter), а не сам исполняемый
5
+ * файл: интерпретатор и аргументы — данные декларации. Реестр скриптов живёт
6
+ * в `.synth/scripts/<name>.md` (проект) > `{dataDir}/scripts` (инстанс) >
7
+ * `config.scripts.paths`; приоритет, trust-гейт и диагностика — те же, что у
8
+ * команд и скиллов (ADR-126 §9).
9
+ *
10
+ * Здесь только типы (без бизнес-логики движка); разбор декларации и запуск —
11
+ * в core (`engine/scripts/*`).
12
+ */
13
+ /** Источник скрипта (приоритет — как у команд/скиллов). */
14
+ export declare const SCRIPT_ORIGINS: readonly ["project", "instance", "config"];
15
+ export type ScriptOrigin = (typeof SCRIPT_ORIGINS)[number];
16
+ /** Уровень диагностики discovery/валидации скриптов. */
17
+ export type ScriptDiagnosticLevel = 'error' | 'warning' | 'info';
18
+ /**
19
+ * Коды диагностики скриптов.
20
+ *
21
+ * - `invalid-frontmatter` — нет frontmatter, невалидный YAML, неверные
22
+ * значения необязательных полей;
23
+ * - `missing-name` — имя скрипта не задано или не соответствует
24
+ * `^[a-z0-9]+(-[a-z0-9]+)*$`;
25
+ * - `invalid-run` — неверные параметры исполнения (`run`/`cwd`/`env`/
26
+ * `timeout`/`requires`);
27
+ * - `shadowed` — одноимённый скрипт перекрыт источником с большим приоритетом;
28
+ * - `read-error` — файл скрипта не прочитан;
29
+ * - `untrusted` — проектный каталог недоверенный: скрипт виден, но не
30
+ * запускается (ADR-126 §9);
31
+ * - `undeclared-executable` — исполняемый файл проекта без декларации
32
+ * (подсказка «объявите скрипт», исполняемой записи не создаёт).
33
+ */
34
+ export type ScriptIssueCode = 'invalid-frontmatter' | 'missing-name' | 'shadowed' | 'read-error' | 'untrusted' | 'invalid-run' | 'undeclared-executable';
35
+ /** Диагностика реестра скриптов (видна в списке скриптов и в диагностике). */
36
+ export interface ScriptDiagnostic {
37
+ level: ScriptDiagnosticLevel;
38
+ code: ScriptIssueCode;
39
+ message: string;
40
+ /** Имя скрипта (если известно). */
41
+ script?: string;
42
+ /** Путь к файлу (если применимо). */
43
+ path?: string;
44
+ }
45
+ /** Сводка скрипта (для списка и автокомплита `!`). */
46
+ export interface ScriptSummary {
47
+ name: string;
48
+ description: string;
49
+ origin: ScriptOrigin;
50
+ /** Подсказка по аргументам (advisory, из `argument-hint`). */
51
+ argumentHint?: string;
52
+ /** `false` — скрипт виден, но недоступен к запуску. */
53
+ available: boolean;
54
+ /** Причина недоступности: `trusted` — недоверенный каталог, `denied` — правило прав. */
55
+ unavailableReason?: 'trusted' | 'denied';
56
+ /** Доверен ли источник скрипта (project-trust гейт, ADR-126 §9). */
57
+ trusted: boolean;
58
+ }
59
+ /**
60
+ * Детали скрипта (декларация целиком).
61
+ *
62
+ * `file` — путь **относительно** источника (workspace проекта / каталога
63
+ * инстанса / каталога конфигурации): абсолютные пути наружу не отдаются.
64
+ */
65
+ export interface ScriptDetail extends ScriptSummary {
66
+ /** Команда запуска (argv-форма — путь к файлу; shell-форма — строка). */
67
+ run: string;
68
+ /** `true` — `run` исполняется оболочкой, иначе — как argv. */
69
+ shell: boolean;
70
+ /** Рабочий каталог относительно рабочего каталога сессии. */
71
+ cwd?: string;
72
+ /** Принимает ли скрипт аргументы (`args` в декларации). */
73
+ args: boolean;
74
+ /** Таймаут запуска, **секунды** (1…86 400; по умолчанию 86 400). */
75
+ timeout?: number;
76
+ /** Бинарные требования запуска. */
77
+ requires?: string[];
78
+ /** Файл декларации (относительный путь). */
79
+ file: string;
80
+ /** Тело декларации — описание действия для человека и агента. */
81
+ body: string;
82
+ }
83
+ /**
84
+ * Ответ запуска скрипта — по смыслу совпадает с ответом фонового процесса.
85
+ *
86
+ * Скрипт всегда стартует фоновым процессом (ADR-113): отдельного режима
87
+ * «с ожиданием завершения» нет — декларация такого поля не предусматривает.
88
+ */
89
+ export interface ScriptRunResponse {
90
+ /** id записи реестра фоновых прогонов (`bgr_<uuid>`). */
91
+ run_id: string;
92
+ /** Идентификатор процесса у порта исполнения (`proc_<uuid>`). */
93
+ process_id: string;
94
+ /** Путь лога процесса в blob-хранилище (`processes/<runId>.log`). */
95
+ log_path: string;
96
+ /** Статус запуска — всегда `running` (запуск неблокирующий). */
97
+ status: 'running';
98
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * ADR-126 §5: скрипты проекта (`!`-запуск) — контракты.
3
+ *
4
+ * Скрипт — это **декларация** (markdown + frontmatter), а не сам исполняемый
5
+ * файл: интерпретатор и аргументы — данные декларации. Реестр скриптов живёт
6
+ * в `.synth/scripts/<name>.md` (проект) > `{dataDir}/scripts` (инстанс) >
7
+ * `config.scripts.paths`; приоритет, trust-гейт и диагностика — те же, что у
8
+ * команд и скиллов (ADR-126 §9).
9
+ *
10
+ * Здесь только типы (без бизнес-логики движка); разбор декларации и запуск —
11
+ * в core (`engine/scripts/*`).
12
+ */
13
+ /** Источник скрипта (приоритет — как у команд/скиллов). */
14
+ export const SCRIPT_ORIGINS = ['project', 'instance', 'config'];
@@ -14,7 +14,7 @@ import type { GlobalRole } from './index.js';
14
14
  * не вводится намеренно — иначе он молча покрывал бы будущие `automation:*`-скоупы
15
15
  * (напр. запуск/удаление), не связанные с установкой пакета.
16
16
  */
17
- export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules"];
17
+ export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules", "timers", "mcp"];
18
18
  export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
19
19
  /**
20
20
  * Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
@@ -31,9 +31,12 @@ export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
31
31
  * (консент-сервисы аддонов);
32
32
  * - `plugins:invoke` — server-scoped токен плагина (ADR-090 Ф7, Уровень 2):
33
33
  * ключ, привязанный к `plugin_id`; без этого scope сервер отвергает такой
34
- * ключ (fail-closed).
34
+ * ключ (fail-closed);
35
+ * - `mcp:invoke` — вызов серверных MCP-серверов из гибрида (PROP-125):
36
+ * удалённый вызов инструмента серверного MCP-сервера; интерактивный
37
+ * пользователь гибрида авторизуется `requireAuth` (ADR-043).
35
38
  */
36
- export declare const SERVICE_SCOPES: readonly ["events:ingest", "events:watch", "bindings:read", "bindings:write", "keys:read", "keys:write", "routes:read", "routes:write", "sessions:create", "sessions:read", "sessions:prompt", "schedules:read", "schedules:write", "llm:chat", "addons:install", "automation:install", "users:read", "plugins:invoke"];
39
+ export declare const SERVICE_SCOPES: readonly ["events:ingest", "events:watch", "bindings:read", "bindings:write", "keys:read", "keys:write", "routes:read", "routes:write", "sessions:create", "sessions:read", "sessions:prompt", "schedules:read", "schedules:write", "timers:read", "timers:write", "llm:chat", "addons:install", "automation:install", "users:read", "plugins:invoke", "mcp:invoke"];
37
40
  export type ServiceScope = (typeof SERVICE_SCOPES)[number];
38
41
  /**
39
42
  * ADR-052: «любой из»-наборы скоупов для гейтов, где зонтичный
@@ -43,6 +46,12 @@ export type ServiceScope = (typeof SERVICE_SCOPES)[number];
43
46
  * покрыт **хотя бы один** элемент набора. `routes:write`/`schedules:write`
44
47
  * остаются самостоятельными (правка чужих правил/расписаний), а
45
48
  * `automation:install` — доступ установщика пакета к тем же точкам.
49
+ *
50
+ * PROP-141 (этап 5, B-2): скоупы таймеров/будильников — `timers:read`/
51
+ * `timers:write`. Зонтичный `automation:install` их **не** покрывает:
52
+ * таймер — runtime-автоматизация пользователя, а не артефакт пакета
53
+ * расширений (в отличие от агентов/пайплайнов/правил/расписаний, которые
54
+ * установщик пакета действительно порождает).
46
55
  */
47
56
  export declare const SERVICE_SCOPE_SETS: {
48
57
  /** Запись правил маршрутизации: `routes:write` или установщик пакета. */
@@ -51,6 +60,10 @@ export declare const SERVICE_SCOPE_SETS: {
51
60
  readonly schedulesWrite: readonly ["schedules:write", "automation:install"];
52
61
  /** Установка агентов и их ролевых промптов: установщик пакета. */
53
62
  readonly agentsWrite: readonly ["automation:install"];
63
+ /** Чтение таймеров/будильников (PROP-141, этап 5 B-2). */
64
+ readonly timersRead: readonly ["timers:read"];
65
+ /** Запись таймеров/будильников (PROP-141, этап 5 B-2). */
66
+ readonly timersWrite: readonly ["timers:write"];
54
67
  };
55
68
  /** Набор скоупов «достаточно любого из» (см. `SERVICE_SCOPE_SETS`). */
56
69
  export type ServiceScopeSet = (typeof SERVICE_SCOPE_SETS)[keyof typeof SERVICE_SCOPE_SETS];
@@ -14,6 +14,8 @@ export const SERVICE_SCOPE_FAMILIES = [
14
14
  'routes',
15
15
  'sessions',
16
16
  'schedules',
17
+ 'timers',
18
+ 'mcp',
17
19
  ];
18
20
  /**
19
21
  * Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
@@ -30,7 +32,10 @@ export const SERVICE_SCOPE_FAMILIES = [
30
32
  * (консент-сервисы аддонов);
31
33
  * - `plugins:invoke` — server-scoped токен плагина (ADR-090 Ф7, Уровень 2):
32
34
  * ключ, привязанный к `plugin_id`; без этого scope сервер отвергает такой
33
- * ключ (fail-closed).
35
+ * ключ (fail-closed);
36
+ * - `mcp:invoke` — вызов серверных MCP-серверов из гибрида (PROP-125):
37
+ * удалённый вызов инструмента серверного MCP-сервера; интерактивный
38
+ * пользователь гибрида авторизуется `requireAuth` (ADR-043).
34
39
  */
35
40
  export const SERVICE_SCOPES = [
36
41
  'events:ingest',
@@ -46,11 +51,14 @@ export const SERVICE_SCOPES = [
46
51
  'sessions:prompt',
47
52
  'schedules:read',
48
53
  'schedules:write',
54
+ 'timers:read',
55
+ 'timers:write',
49
56
  'llm:chat',
50
57
  'addons:install',
51
58
  'automation:install',
52
59
  'users:read',
53
60
  'plugins:invoke',
61
+ 'mcp:invoke',
54
62
  ];
55
63
  /**
56
64
  * ADR-052: «любой из»-наборы скоупов для гейтов, где зонтичный
@@ -60,6 +68,12 @@ export const SERVICE_SCOPES = [
60
68
  * покрыт **хотя бы один** элемент набора. `routes:write`/`schedules:write`
61
69
  * остаются самостоятельными (правка чужих правил/расписаний), а
62
70
  * `automation:install` — доступ установщика пакета к тем же точкам.
71
+ *
72
+ * PROP-141 (этап 5, B-2): скоупы таймеров/будильников — `timers:read`/
73
+ * `timers:write`. Зонтичный `automation:install` их **не** покрывает:
74
+ * таймер — runtime-автоматизация пользователя, а не артефакт пакета
75
+ * расширений (в отличие от агентов/пайплайнов/правил/расписаний, которые
76
+ * установщик пакета действительно порождает).
63
77
  */
64
78
  export const SERVICE_SCOPE_SETS = {
65
79
  /** Запись правил маршрутизации: `routes:write` или установщик пакета. */
@@ -68,6 +82,10 @@ export const SERVICE_SCOPE_SETS = {
68
82
  schedulesWrite: ['schedules:write', 'automation:install'],
69
83
  /** Установка агентов и их ролевых промптов: установщик пакета. */
70
84
  agentsWrite: ['automation:install'],
85
+ /** Чтение таймеров/будильников (PROP-141, этап 5 B-2). */
86
+ timersRead: ['timers:read'],
87
+ /** Запись таймеров/будильников (PROP-141, этап 5 B-2). */
88
+ timersWrite: ['timers:write'],
71
89
  };
72
90
  /**
73
91
  * `true`, если строка — известный скоуп: элемент каталога либо wildcard
@@ -33,6 +33,33 @@ export interface SessionStatus {
33
33
  queueStopped?: boolean;
34
34
  /** Время остановки обработки очереди (ISO) — для диагностики/аудита. */
35
35
  queueStoppedAt?: string;
36
+ /**
37
+ * Durable-счётчик автовосстановления прерванного хода (PROP-142 §3) —
38
+ * бюджет попыток на ход + детект crash-loop. Живёт в JSON-документе сессии
39
+ * (файловое хранилище и PostgreSQL — одно и то же поле), поэтому переживает
40
+ * рестарт инстанса.
41
+ *
42
+ * Сбрасывается терминальным статусом хода (ход завершился — бюджет не
43
+ * израсходован) и ручным повтором восстановления (`recovery/retry`).
44
+ * Отсутствие поля = «автовосстановление ещё не пробовали».
45
+ */
46
+ recovery?: SessionRecoveryState;
47
+ }
48
+ /**
49
+ * Состояние автовосстановления прерванного хода (PROP-142 §3).
50
+ *
51
+ * - `attempts` — сколько раз инстанс автоматически возобновлял прерванный ход;
52
+ * - `attemptsAt` — метки попыток (ISO), хранится хвост (≤ 10 записей): по ним
53
+ * считается crash-loop (N попыток за M минут);
54
+ * - `lastAt` — момент последней попытки (ISO).
55
+ */
56
+ export interface SessionRecoveryState {
57
+ /** Сколько раз инстанс автоматически возобновлял прерванный ход. */
58
+ attempts: number;
59
+ /** Моменты попыток (ISO, храним последние ≤10) — детект crash-loop. */
60
+ attemptsAt: string[];
61
+ /** Момент последней попытки (ISO). */
62
+ lastAt?: string;
36
63
  }
37
64
  export declare const PLAN_MODES: readonly ["auto", "strict", "off"];
38
65
  export type PlanMode = (typeof PLAN_MODES)[number];
@@ -131,6 +158,22 @@ export interface SessionSettings {
131
158
  debugEnabled: boolean;
132
159
  streamEnabled: boolean;
133
160
  agentRole?: string;
161
+ /**
162
+ * PROP-135 Ф4a: имя профиля исполнения сессии (`execution.remote.profiles`).
163
+ *
164
+ * Порт тулов сессии выбирает роутер по этому имени (см.
165
+ * `packages/core/src/execution/router.ts`). Не задан — профиль по умолчанию
166
+ * (`execution.remote.defaultProfile`). Полный binding профиля
167
+ * (`task.executor_profile` → `agentDefinition.executorProfile` →
168
+ * `project.executor.profile`) — Ф6; на этом шаге поле только в типах.
169
+ */
170
+ executorProfile?: string;
171
+ /**
172
+ * PROP-135 (браузерный контур): профиль браузерного пула сессии
173
+ * (`execution.remote.browserProfiles`). Не задан — наследуется профиль
174
+ * агента/проекта/инстанса (`execution.remote.browserProfile`).
175
+ */
176
+ browserProfile?: string;
134
177
  /** ADR-071 §2.4: явно включённые в сессии серверы (session level). */
135
178
  mcpServers?: string[];
136
179
  /**
@@ -240,12 +283,12 @@ export interface SessionSettings {
240
283
  mcpPolicy?: ToolsPolicy;
241
284
  /** Строгость цикла Plan→Build: auto — модель сама решает, strict — план обязателен, off — планирование отключено. */
242
285
  planMode?: PlanMode;
243
- /** ADR-046: явно включённые в сессии имена скиллов (session level, volatile-каталог). */
286
+ /** ADR-126: явно включённые в сессии имена скиллов (session level, volatile-каталог). */
244
287
  skills?: string[];
245
- /** ADR-046: opt-out сессии — имена, категории или группы скиллов (volatile-каталог). */
288
+ /** ADR-126: opt-out сессии — имена, категории или группы скиллов (volatile-каталог). */
246
289
  skillsDisabled?: string[];
247
290
  /**
248
- * ADR-046: СНАПШОТ скиллов «по умолчанию» на момент создания сессии (снимок
291
+ * ADR-126: СНАПШОТ скиллов «по умолчанию» на момент создания сессии (снимок
249
292
  * `project.skills.defaultOn` либо системного дефолта). Изменение дефолта
250
293
  * проекта/системы не влияет на существующие сессии.
251
294
  */
@@ -422,6 +465,14 @@ export interface Session {
422
465
  userId?: string;
423
466
  ownerId?: string;
424
467
  projectId?: string;
468
+ /**
469
+ * Маркер источника при переносе между инстансами (publish/import): id сессии
470
+ * в исходном мире. Используется как **ключ дедупликации повторного импорта** —
471
+ * повторная загрузка той же сессии в тот же проект обновляет существующую
472
+ * запись, а не создаёт дубль. Поле аддитивное: у сессий, созданных локально
473
+ * (и у записей до появления поля), оно отсутствует.
474
+ */
475
+ sourceSessionId?: string;
425
476
  /**
426
477
  * ADR-114: привязка сессии к git-worktree — рабочий каталог сессии.
427
478
  * Аддитивное поле: сессии, созданные до ADR-114, его не имеют и работают
@@ -482,6 +533,20 @@ export interface Session {
482
533
  */
483
534
  cacheHitRate?: number;
484
535
  }
536
+ /**
537
+ * Метаданные сессии — документ без истории и child-наборов.
538
+ *
539
+ * Используется атомарной операцией порта `SessionRepository.mutateMeta`
540
+ * (ADR-096): «чтение → изменение → запись» метаданных под одним локом, без
541
+ * чтения и перезаписи истории (`messages`/`checkpoints`) и связей
542
+ * (`references`). `stickyNotes` намеренно **не входит**: в PostgreSQL это
543
+ * отдельная child-таблица, а `mutateMeta` не имеет права её трогать
544
+ * (иначе файловая и SQL-реализации разошлись бы по семантике).
545
+ *
546
+ * `pendingMessages`/`steerInbox` остаются частью метаданных: это jsonb-колонки
547
+ * самой записи сессии (не child-таблица), малы и нужны recovery/автозапуску.
548
+ */
549
+ export type SessionMeta = Omit<Session, 'messages' | 'checkpoints' | 'references' | 'stickyNotes'>;
485
550
  export interface QueueItem {
486
551
  message: Message;
487
552
  streamId: string;
@@ -1,28 +1,28 @@
1
1
  import type { ToolCapability } from './tools.js';
2
2
  /**
3
- * ADR-046 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
3
+ * ADR-126 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
4
4
  * Здесь только контракты (типы), без бизнес-логики движка.
5
5
  */
6
- /** Фактический источник скилла (ADR-046 §4.1). */
6
+ /** Фактический источник скилла (ADR-126 §7). */
7
7
  export declare const SKILL_SCOPES: readonly ["instance", "project"];
8
8
  export type SkillScope = (typeof SKILL_SCOPES)[number];
9
- /** Уровень включения скилла (модель ADR-071 §2.4/ADR-046 §4.5). */
9
+ /** Уровень включения скилла (модель ADR-071 §2.4/ADR-126 §11). */
10
10
  export declare const SKILL_LEVELS: readonly ["system", "project", "session"];
11
11
  export type SkillLevel = (typeof SKILL_LEVELS)[number];
12
12
  /**
13
- * ADR-046 §6.1: способ вызова скилла — комбинация `user-invocable` /
13
+ * ADR-126 §3: способ вызова скилла — комбинация `user-invocable` /
14
14
  * `disable-model-invocation`.
15
15
  */
16
16
  export declare const SKILL_INVOCATIONS: readonly ["both", "user", "model", "none"];
17
17
  export type SkillInvocation = (typeof SKILL_INVOCATIONS)[number];
18
- /** ADR-046 §3.2: подсказка авто-применения (не разрешение). */
18
+ /** ADR-126 §13: подсказка авто-применения (не разрешение). */
19
19
  export declare const SKILL_TRIGGERS: readonly ["manual", "auto"];
20
20
  export type SkillTrigger = (typeof SKILL_TRIGGERS)[number];
21
- /** ADR-046 §3.2: применимость скилла по режиму сессии (ADR-025). */
21
+ /** ADR-126 §13: применимость скилла по режиму сессии (ADR-025). */
22
22
  export declare const SKILL_MODES: readonly ["plan", "act", "any"];
23
23
  export type SkillMode = (typeof SKILL_MODES)[number];
24
24
  /**
25
- * ADR-046 §3.2: нормализованный frontmatter `SKILL.md` (после толерантного парсинга).
25
+ * ADR-126 §13: нормализованный frontmatter `SKILL.md` (после толерантного парсинга).
26
26
  * Неизвестные top-level ключи не теряются — попадают в `extra`.
27
27
  */
28
28
  export interface SkillMeta {
@@ -57,6 +57,10 @@ export interface SkillMeta {
57
57
  /** Декларативная подсказка; фактический scope задаёт источник. */
58
58
  scope?: SkillScope;
59
59
  trigger?: SkillTrigger;
60
+ /**
61
+ * Legacy: имя `/`-команды скилла больше не используется (ADR-126 §7).
62
+ * Поле читается для совместимости frontmatter, но `/name` не создаёт.
63
+ */
60
64
  command?: string;
61
65
  mode?: SkillMode;
62
66
  /** Неизвестные top-level ключи frontmatter (совместимость). */
@@ -66,7 +70,7 @@ export interface SkillMeta {
66
70
  export type SkillDiagnosticLevel = 'error' | 'warning' | 'info';
67
71
  /** Код диагностики/проблемы парсинга. */
68
72
  export type SkillIssueCode = 'missing-frontmatter' | 'invalid-frontmatter' | 'invalid-frontmatter-type' | 'missing-name' | 'invalid-name' | 'name-mismatch' | 'missing-description' | 'invalid-description' | 'none-invocation' | 'shadowed' | 'untrusted' | 'read-error'
69
- /** ADR-046 §4.2: ошибка удалённого каталога (`skills.urls`): URL/индекс/парсинг. */
73
+ /** ADR-126 §7: ошибка удалённого каталога (`skills.urls`): URL/индекс/парсинг. */
70
74
  | 'remote';
71
75
  /** Проблема парсинга/валидации одного скилла. */
72
76
  export interface SkillIssue {
@@ -84,7 +88,7 @@ export interface SkillDiagnostic extends SkillIssue {
84
88
  dir?: string;
85
89
  }
86
90
  /**
87
- * Запись реестра скиллов (ADR-046 §4.5). Доступна через API/диагностику; тело
91
+ * Запись реестра скиллов (ADR-126 §11). Доступна через API/диагностику; тело
88
92
  * скилла в каталог промпта не попадает (progressive disclosure, §5).
89
93
  */
90
94
  export interface SkillSummary {
@@ -92,7 +96,7 @@ export interface SkillSummary {
92
96
  description: string;
93
97
  /** Фактический scope из источника. */
94
98
  scope: SkillScope;
95
- /** Уровень из источника (system/project; session — ADR-046 §4.5, Фаза 1 без хранения). */
99
+ /** Уровень из источника (system/project; session — ADR-126 §11, Фаза 1 без хранения). */
96
100
  level: SkillLevel;
97
101
  /** Абсолютный путь каталога скилла. */
98
102
  dir: string;
@@ -111,6 +115,12 @@ export interface SkillSummary {
111
115
  */
112
116
  available: boolean;
113
117
  unavailableReason?: 'capabilities';
118
+ /**
119
+ * Каких именно capabilities не хватает (`available: false`, причина
120
+ * `capabilities`). Аддитивно: используется UI для подсказки «Не хватает
121
+ * возможностей: …»; при доступном скилле поля нет.
122
+ */
123
+ missingCapabilities?: string[];
114
124
  }
115
125
  /** Детали скилла (тело + supporting-файлы). */
116
126
  export interface SkillDetail extends SkillSummary {
@@ -128,7 +138,7 @@ export interface SkillCatalogFilter {
128
138
  };
129
139
  /** Capabilities агента для проверки `requires_capabilities`. */
130
140
  capabilities?: readonly string[];
131
- /** Per-session явное включение имён (volatile, ADR-046 §4.5). */
141
+ /** Per-session явное включение имён (volatile, ADR-126 §11). */
132
142
  sessionEnabled?: string[];
133
143
  /** Per-session opt-out имён/групп/категорий (volatile). */
134
144
  sessionDisabled?: string[];
@@ -1,17 +1,17 @@
1
1
  /**
2
- * ADR-046 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
2
+ * ADR-126 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
3
3
  * Здесь только контракты (типы), без бизнес-логики движка.
4
4
  */
5
- /** Фактический источник скилла (ADR-046 §4.1). */
5
+ /** Фактический источник скилла (ADR-126 §7). */
6
6
  export const SKILL_SCOPES = ['instance', 'project'];
7
- /** Уровень включения скилла (модель ADR-071 §2.4/ADR-046 §4.5). */
7
+ /** Уровень включения скилла (модель ADR-071 §2.4/ADR-126 §11). */
8
8
  export const SKILL_LEVELS = ['system', 'project', 'session'];
9
9
  /**
10
- * ADR-046 §6.1: способ вызова скилла — комбинация `user-invocable` /
10
+ * ADR-126 §3: способ вызова скилла — комбинация `user-invocable` /
11
11
  * `disable-model-invocation`.
12
12
  */
13
13
  export const SKILL_INVOCATIONS = ['both', 'user', 'model', 'none'];
14
- /** ADR-046 §3.2: подсказка авто-применения (не разрешение). */
14
+ /** ADR-126 §13: подсказка авто-применения (не разрешение). */
15
15
  export const SKILL_TRIGGERS = ['manual', 'auto'];
16
- /** ADR-046 §3.2: применимость скилла по режиму сессии (ADR-025). */
16
+ /** ADR-126 §13: применимость скилла по режиму сессии (ADR-025). */
17
17
  export const SKILL_MODES = ['plan', 'act', 'any'];