@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
package/dist/types/git.js CHANGED
@@ -1 +1,101 @@
1
- export {};
1
+ // --- Git ---
2
+ import { HOST_RULE_FORMAT_HINT, isValidHostRule } from './host-pattern.js';
3
+ /** Канонический список типов использования SSH-ключа (PROP-124). */
4
+ export const SSH_KEY_USAGES = ['git', 'ssh'];
5
+ /** Канонический список режимов инстанса (PROP-124). */
6
+ export const SSH_MODES = ['tools', 'agent'];
7
+ /** Предел числа хостов в политике ключа (PROP-124) — `allowHosts`. */
8
+ export const MAX_SSH_ALLOW_HOSTS = 50;
9
+ /** Предел числа портов в политике ключа (PROP-124) — `allowPorts`. */
10
+ export const MAX_SSH_ALLOW_PORTS = 10;
11
+ /**
12
+ * PROP-124: нормализация типов использования ключа.
13
+ *
14
+ * Поле отсутствует (ключ создан до Ф1) → `['git']` (fail-closed: git-путь
15
+ * работает как раньше). Явно пустой массив сохраняется пустым — но записать
16
+ * его больше нельзя (см. `validateSshKeyPolicy`): в таких легаси-записях ключ
17
+ * не проходит гейт ни для git, ни для ssh.
18
+ */
19
+ export function normalizeSshKeyUsages(usages) {
20
+ if (usages === undefined)
21
+ return ['git'];
22
+ return [...usages];
23
+ }
24
+ /**
25
+ * PROP-124: нормализация списка хостов — отсутствует → `[]`; элементы
26
+ * обрезаются от пробелов, пустые отбрасываются.
27
+ */
28
+ export function normalizeSshKeyAllowHosts(hosts) {
29
+ if (!hosts)
30
+ return [];
31
+ return hosts.map((host) => host.trim()).filter((host) => host !== '');
32
+ }
33
+ /**
34
+ * PROP-124: нормализация списка портов — отсутствует → `[]`.
35
+ * Порты-дубликаты сохраняются (смысла дедуплицировать нет, порядок важен
36
+ * только для отображения).
37
+ */
38
+ export function normalizeSshKeyAllowPorts(ports) {
39
+ if (!ports)
40
+ return [];
41
+ return [...ports];
42
+ }
43
+ /**
44
+ * PROP-124: проверка политики ключа — типы использования, правила хостов и
45
+ * порты. Fail-closed: любое нарушение → отказ с понятным сообщением
46
+ * (`message` — для ответа API `400 VALIDATION_ERROR`).
47
+ */
48
+ export function validateSshKeyPolicy(input) {
49
+ if (input.usages) {
50
+ // Пустой список — «ключ, который ничего не умеет»: не годен ни для git,
51
+ // ни для ssh. Запрещён на записи (и в API-схеме, и в хранилищах).
52
+ if (input.usages.length === 0) {
53
+ return {
54
+ ok: false,
55
+ message: `usages: нужен хотя бы один способ использования (${SSH_KEY_USAGES.join('|')})`,
56
+ };
57
+ }
58
+ for (const usage of input.usages) {
59
+ if (!SSH_KEY_USAGES.includes(usage)) {
60
+ return { ok: false, message: `usages: недопустимое значение "${usage}" (ожидается ${SSH_KEY_USAGES.join('|')})` };
61
+ }
62
+ }
63
+ }
64
+ if (input.allowHosts) {
65
+ if (input.allowHosts.length > MAX_SSH_ALLOW_HOSTS) {
66
+ return {
67
+ ok: false,
68
+ message: `allowHosts: не больше ${MAX_SSH_ALLOW_HOSTS} правил на ключ`,
69
+ };
70
+ }
71
+ for (const raw of input.allowHosts) {
72
+ const rule = typeof raw === 'string' ? raw.trim() : '';
73
+ if (!rule) {
74
+ return { ok: false, message: 'allowHosts: пустые правила недопустимы' };
75
+ }
76
+ if (!isValidHostRule(rule)) {
77
+ return {
78
+ ok: false,
79
+ message: `allowHosts: невалидный шаблон хоста "${rule}" — ${HOST_RULE_FORMAT_HINT}`,
80
+ };
81
+ }
82
+ }
83
+ }
84
+ if (input.allowPorts) {
85
+ if (input.allowPorts.length > MAX_SSH_ALLOW_PORTS) {
86
+ return {
87
+ ok: false,
88
+ message: `allowPorts: не больше ${MAX_SSH_ALLOW_PORTS} портов на ключ`,
89
+ };
90
+ }
91
+ for (const port of input.allowPorts) {
92
+ if (!Number.isInteger(port) || port < 1 || port > 65535) {
93
+ return {
94
+ ok: false,
95
+ message: `allowPorts: недопустимый порт "${port}" (ожидается целое 1..65535)`,
96
+ };
97
+ }
98
+ }
99
+ }
100
+ return { ok: true };
101
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Единая семантика правил хоста (ADR-099 — TLS/proxy; PROP-124 — политика
3
+ * SSH-ключей).
4
+ *
5
+ * Модуль **browser-safe** (без `node:*`): его читают и роуты ядра, и UI
6
+ * (`@itphx/synth-shared/types`). Поэтому реализация `normalizeTlsHost` /
7
+ * `matchTlsHostPattern` живёт здесь, а `config/tls.ts` её переиспользует —
8
+ * второй матчер шаблонов хоста в кодовой базе не заводим (ADR-099: семантика
9
+ * шаблона хоста общая для TLS, egress-политики и SSH).
10
+ *
11
+ * Грамматика правила:
12
+ * - **точный hostname** (`git.example.com`);
13
+ * - **`*.suffix`** — только поддомены (сам `suffix` требует отдельного правила);
14
+ * - **IP-литерал** (`10.0.0.5`) и **CIDR** (`10.0.0.0/8`) — адресные правила,
15
+ * которые матчатся **только по IP-литералу** хоста (никогда по hostname);
16
+ * - одиночный **`*`** («любой хост») — **недопустим** в правилах политики
17
+ * (fail-closed): иначе исключение разрешило бы любой адрес. В TLS-профилях
18
+ * `*` допустим (см. `matchTlsHostPattern`) — там это явный выбор админа.
19
+ */
20
+ /** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
21
+ export declare function normalizeTlsHost(rawHost: string | undefined): string | undefined;
22
+ /**
23
+ * Матчинг одного шаблона (`host` | `*.suffix` | `*`); регистронезависимо.
24
+ *
25
+ * `*` («любой хост») здесь допустим — им пользуются TLS-профили per-host
26
+ * (ADR-099). Для **политик** (`allowHosts` SSH-ключа) `*` недопустим —
27
+ * это проверяет `isValidHostRule`.
28
+ */
29
+ export declare function matchTlsHostPattern(pattern: string, rawHost: string): boolean;
30
+ /** IP-литерал любого семейства. */
31
+ export declare function isIpLiteral(value: string): boolean;
32
+ /**
33
+ * Валидна ли одна запись правила хоста: точный hostname, `*.suffix`, IP-литерал
34
+ * или CIDR. Пустые строки, regex-подобные записи и одиночный `*` — невалидны.
35
+ *
36
+ * Семантика — та же, что у egress-политики (`isValidEgressRule` в ядре), но
37
+ * реализация browser-safe: правило проверяется и в роутах ядра, и в UI.
38
+ */
39
+ export declare function isValidHostRule(raw: string): boolean;
40
+ /** Подсказка по допустимому виду правила — для сообщений об ошибке. */
41
+ export declare const HOST_RULE_FORMAT_HINT = "\u043E\u0436\u0438\u0434\u0430\u0435\u0442\u0441\u044F hostname (git.example.com), \u043F\u043E\u0434\u0434\u043E\u043C\u0435\u043D\u044B (*.corp.example), IP-\u043B\u0438\u0442\u0435\u0440\u0430\u043B \u0438\u043B\u0438 CIDR (10.0.0.0/8)";
@@ -0,0 +1,143 @@
1
+ /**
2
+ * Единая семантика правил хоста (ADR-099 — TLS/proxy; PROP-124 — политика
3
+ * SSH-ключей).
4
+ *
5
+ * Модуль **browser-safe** (без `node:*`): его читают и роуты ядра, и UI
6
+ * (`@itphx/synth-shared/types`). Поэтому реализация `normalizeTlsHost` /
7
+ * `matchTlsHostPattern` живёт здесь, а `config/tls.ts` её переиспользует —
8
+ * второй матчер шаблонов хоста в кодовой базе не заводим (ADR-099: семантика
9
+ * шаблона хоста общая для TLS, egress-политики и SSH).
10
+ *
11
+ * Грамматика правила:
12
+ * - **точный hostname** (`git.example.com`);
13
+ * - **`*.suffix`** — только поддомены (сам `suffix` требует отдельного правила);
14
+ * - **IP-литерал** (`10.0.0.5`) и **CIDR** (`10.0.0.0/8`) — адресные правила,
15
+ * которые матчатся **только по IP-литералу** хоста (никогда по hostname);
16
+ * - одиночный **`*`** («любой хост») — **недопустим** в правилах политики
17
+ * (fail-closed): иначе исключение разрешило бы любой адрес. В TLS-профилях
18
+ * `*` допустим (см. `matchTlsHostPattern`) — там это явный выбор админа.
19
+ */
20
+ /** Допустимый hostname (в т.ч. `*.suffix`): буквы/цифры/дефис/подчёркивание и точки. */
21
+ const HOSTNAME_RULE_RE = /^(\*\.)?[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?(?:\.[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)*\.?$/i;
22
+ /** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
23
+ export function normalizeTlsHost(rawHost) {
24
+ if (typeof rawHost !== 'string')
25
+ return undefined;
26
+ let host = rawHost.trim().toLowerCase().replace(/\.$/, '');
27
+ if (host.startsWith('[') && host.endsWith(']'))
28
+ host = host.slice(1, -1);
29
+ return host === '' ? undefined : host;
30
+ }
31
+ /**
32
+ * Матчинг одного шаблона (`host` | `*.suffix` | `*`); регистронезависимо.
33
+ *
34
+ * `*` («любой хост») здесь допустим — им пользуются TLS-профили per-host
35
+ * (ADR-099). Для **политик** (`allowHosts` SSH-ключа) `*` недопустим —
36
+ * это проверяет `isValidHostRule`.
37
+ */
38
+ export function matchTlsHostPattern(pattern, rawHost) {
39
+ const host = normalizeTlsHost(rawHost);
40
+ if (host === undefined)
41
+ return false;
42
+ const value = pattern.trim().toLowerCase().replace(/\.$/, '');
43
+ if (value === '*')
44
+ return true;
45
+ if (value.startsWith('*.')) {
46
+ const suffix = value.slice(2);
47
+ return suffix !== '' && host.endsWith(`.${suffix}`);
48
+ }
49
+ return host === value;
50
+ }
51
+ /** IPv4-литерал (`10.0.0.5`); ведущие нули не допускаются (как в `net.isIP`). */
52
+ function isIpv4Literal(value) {
53
+ const parts = value.split('.');
54
+ if (parts.length !== 4)
55
+ return false;
56
+ return parts.every((part) => /^\d{1,3}$/.test(part) &&
57
+ Number(part) <= 255 &&
58
+ (part === '0' || !part.startsWith('0')));
59
+ }
60
+ /**
61
+ * IPv6-литерал: восемь групп, сжатие `::` (хотя бы одну группу) и встроенный
62
+ * IPv4 в последней группе.
63
+ */
64
+ function isIpv6Literal(value) {
65
+ if (!value.includes(':'))
66
+ return false;
67
+ const halves = value.split('::');
68
+ if (halves.length > 2)
69
+ return false;
70
+ const countGroups = (part) => {
71
+ if (part === '')
72
+ return 0;
73
+ const groups = part.split(':');
74
+ let count = 0;
75
+ for (let i = 0; i < groups.length; i++) {
76
+ const group = groups[i];
77
+ if (group.includes('.')) {
78
+ // Встроенный IPv4 допустим только в последней группе и занимает 2 группы.
79
+ if (i !== groups.length - 1)
80
+ return null;
81
+ if (!isIpv4Literal(group))
82
+ return null;
83
+ count += 2;
84
+ continue;
85
+ }
86
+ if (!/^[0-9a-fA-F]{1,4}$/.test(group))
87
+ return null;
88
+ count += 1;
89
+ }
90
+ return count;
91
+ };
92
+ const head = countGroups(halves[0]);
93
+ if (head === null)
94
+ return false;
95
+ if (halves.length === 1)
96
+ return head === 8;
97
+ const tail = countGroups(halves[1]);
98
+ if (tail === null)
99
+ return false;
100
+ // `::` обязан сжимать хотя бы одну группу из восьми.
101
+ return head + tail <= 7;
102
+ }
103
+ /** IP-литерал любого семейства. */
104
+ export function isIpLiteral(value) {
105
+ return isIpv4Literal(value) || isIpv6Literal(value);
106
+ }
107
+ /** CIDR-правило: адресная часть — IP-литерал, префикс — в границах семейства. */
108
+ function isCidrRule(value) {
109
+ const slash = value.lastIndexOf('/');
110
+ if (slash <= 0)
111
+ return false;
112
+ const address = value.slice(0, slash);
113
+ const prefixRaw = value.slice(slash + 1);
114
+ if (!/^\d{1,3}$/.test(prefixRaw))
115
+ return false;
116
+ const prefix = Number(prefixRaw);
117
+ if (isIpv4Literal(address))
118
+ return prefix <= 32;
119
+ if (isIpv6Literal(address))
120
+ return prefix <= 128;
121
+ return false;
122
+ }
123
+ /**
124
+ * Валидна ли одна запись правила хоста: точный hostname, `*.suffix`, IP-литерал
125
+ * или CIDR. Пустые строки, regex-подобные записи и одиночный `*` — невалидны.
126
+ *
127
+ * Семантика — та же, что у egress-политики (`isValidEgressRule` в ядре), но
128
+ * реализация browser-safe: правило проверяется и в роутах ядра, и в UI.
129
+ */
130
+ export function isValidHostRule(raw) {
131
+ if (typeof raw !== 'string')
132
+ return false;
133
+ const rule = raw.trim();
134
+ if (!rule)
135
+ return false;
136
+ if (rule.includes('/'))
137
+ return isCidrRule(rule);
138
+ if (isIpLiteral(rule))
139
+ return true;
140
+ return HOSTNAME_RULE_RE.test(rule);
141
+ }
142
+ /** Подсказка по допустимому виду правила — для сообщений об ошибке. */
143
+ export const HOST_RULE_FORMAT_HINT = 'ожидается hostname (git.example.com), поддомены (*.corp.example), IP-литерал или CIDR (10.0.0.0/8)';
@@ -7,7 +7,10 @@ export * from './plugin-tools.js';
7
7
  export * from './plugin-protocol.js';
8
8
  export * from './mcp.js';
9
9
  export * from './project.js';
10
+ export * from './project-access.js';
10
11
  export * from './git.js';
12
+ export * from './execution.js';
13
+ export * from './host-pattern.js';
11
14
  export * from './user.js';
12
15
  export * from './agent.js';
13
16
  export * from './provider.js';
@@ -17,10 +20,13 @@ export * from './message-stream.js';
17
20
  export * from './steering.js';
18
21
  export * from './fs.js';
19
22
  export * from './file-kind.js';
23
+ export * from './mentions.js';
24
+ export { DEFAULT_CONTEXT_WINDOW } from '../model-metadata.js';
20
25
  export * from './tools.js';
21
26
  export * from './permission.js';
22
27
  export * from './skills.js';
23
28
  export * from './commands.js';
29
+ export * from './scripts.js';
24
30
  export * from './events.js';
25
31
  export * from './hooks.js';
26
32
  export * from './schedules.js';
@@ -30,6 +36,7 @@ export * from './webhooks.js';
30
36
  export * from './external-credentials.js';
31
37
  export * from './maintenance.js';
32
38
  export * from './egress.js';
39
+ export * from './command-audit.js';
33
40
  export * from './analytics.js';
34
41
  export * from './pack.js';
35
42
  export * from './semver.js';
@@ -45,3 +52,4 @@ export * from './pipeline-engine.js';
45
52
  export * from './question.js';
46
53
  export * from './background.js';
47
54
  export * from './worktree.js';
55
+ export * from './timers.js';
@@ -20,8 +20,16 @@ export * from './plugin-protocol.js';
20
20
  export * from './mcp.js';
21
21
  // Проекты, workspace-политика, иконки/цвета, план (ADR-039/075)
22
22
  export * from './project.js';
23
- // Git-репозитории и SSH-ключи (ADR-076)
23
+ // PROP-133 §1: единая точка истины по доступу к проекту (резолвер + нормализация)
24
+ export * from './project-access.js';
25
+ // Git-репозитории и SSH-ключи (ADR-076, PROP-124)
24
26
  export * from './git.js';
27
+ // ADR-135: канонические перечисления секции `execution` + runtime-каталог
28
+ // профилей исполнения (browser-safe — читают и ядро, и UI).
29
+ export * from './execution.js';
30
+ // Единая семантика правил хоста (ADR-099 — TLS/egress; PROP-124 — SSH-политика):
31
+ // browser-safe, поэтому читается и ядром, и UI.
32
+ export * from './host-pattern.js';
25
33
  // Пользователи, auth и внешние идентичности (ADR-089)
26
34
  export * from './user.js';
27
35
  // Агенты (определения и режимы)
@@ -42,15 +50,24 @@ export * from './fs.js';
42
50
  // Классификация файла по расширению (kind/MIME, allow-list inline-предпросмотра)
43
51
  // — browser-safe контракт для UI и ядра.
44
52
  export * from './file-kind.js';
53
+ // ADR-126 §2/§2: контракты «поверхности ввода» — упоминания (`@`), скиллы (`$`)
54
+ // и сниппеты (`#`): span'ы, виды токенов и результат разбора (browser-safe —
55
+ // читают и ядро, и UI; сам разбор — в core, `engine/input-surface/parser.ts`).
56
+ export * from './mentions.js';
57
+ // Оценка контекстного окна при неизвестном окне модели — общая константа ядра
58
+ // и UI (browser-safe: без node:*; значение — см. `model-metadata.ts`).
59
+ export { DEFAULT_CONTEXT_WINDOW } from '../model-metadata.js';
45
60
  // --- Реэкспорт существующих доменных модулей ---
46
61
  // Tool types — re-exported from tools.ts
47
62
  export * from './tools.js';
48
63
  // Permission types (ADR-029) — re-exported from permission.ts
49
64
  export * from './permission.js';
50
- // Skill types (ADR-046) — re-exported from skills.ts
65
+ // Skill types (ADR-126) — re-exported from skills.ts
51
66
  export * from './skills.js';
52
- // Slash-команды и bundles (ADR-046 §7) — re-exported from commands.ts
67
+ // Slash-команды и bundles (ADR-126 §1) — re-exported from commands.ts
53
68
  export * from './commands.js';
69
+ // Скрипты проекта (`!`-запуск, ADR-126 §5) — re-exported from scripts.ts
70
+ export * from './scripts.js';
54
71
  // Внешние события (ADR-089) — re-exported from events.ts
55
72
  export * from './events.js';
56
73
  // Hooks агента и интеграций (ADR-030) — re-exported from hooks.ts
@@ -70,6 +87,8 @@ export * from './external-credentials.js';
70
87
  export * from './maintenance.js';
71
88
  // Egress-политика, журнал внешних запросов и аудит security-политик
72
89
  export * from './egress.js';
90
+ // PROP-136: append-only аудит исполнений shell/песочных команд
91
+ export * from './command-audit.js';
73
92
  // Аналитика и отчётность инстанса: суточные роллапы (ADR-102)
74
93
  export * from './analytics.js';
75
94
  // ADR-086/ADR-090: единый манифест расширения `synth.pack` — типы и zod-схемы
@@ -108,3 +127,6 @@ export * from './background.js';
108
127
  // Этап 1 roadmap 0.13 (блок 1.4): git worktrees — per-session рабочий каталог
109
128
  // (ADR-114): тип записи, тела HTTP-входа и привязка сессии.
110
129
  export * from './worktree.js';
130
+ // PROP-141 (Часть B): таймеры и будильники — модель автоматизации, лимиты
131
+ // и Zod-схемы (порты хранения — в core, ADR-096).
132
+ export * from './timers.js';
@@ -9,7 +9,7 @@
9
9
  * `{dataDir}/audit/maintenance.jsonl`.
10
10
  */
11
11
  /** ADR-092: вид операции обслуживания инстанса. */
12
- export type MaintenanceAuditOp = 'backup.created' | 'backup.failed' | 'backup.deleted' | 'restore.scheduled' | 'restore.cancelled' | 'restore.applied' | 'restore.failed' | 'migrate.applied' | 'migrate.failed' | 'update.applied' | 'rollback.applied' | 'update.failed' | 'uninstall.purge' | 'export.created' | 'import.applied' | 'restart.requested';
12
+ export type MaintenanceAuditOp = 'backup.created' | 'backup.failed' | 'backup.deleted' | 'restore.scheduled' | 'restore.cancelled' | 'restore.applied' | 'restore.failed' | 'migrate.applied' | 'migrate.failed' | 'update.applied' | 'update.checked' | 'rollback.applied' | 'update.failed' | 'uninstall.purge' | 'export.created' | 'import.applied' | 'restart.requested';
13
13
  /** ADR-092: итог операции обслуживания. */
14
14
  export type MaintenanceAuditStatus = 'ok' | 'failed' | 'scheduled';
15
15
  /**
@@ -6,6 +6,18 @@ export declare const MCP_REGISTRY_ORIGINS: readonly ["instance", "user"];
6
6
  export type McpRegistryOrigin = (typeof MCP_REGISTRY_ORIGINS)[number];
7
7
  export declare const MCP_REGISTRY_TRUST_LEVELS: readonly ["builtin", "community"];
8
8
  export type McpRegistryTrust = (typeof MCP_REGISTRY_TRUST_LEVELS)[number];
9
+ /**
10
+ * PROP-125: режим доставки серверного MCP-сервера в локальные сессии гибрида.
11
+ *
12
+ * - `auto` — `relay` для `http`/`sse`, `tools` для `stdio` (дефолт);
13
+ * - `relay` — полноценный MCP-клиент через backend (`/api/v2/mcp/relay/:name`);
14
+ * - `tools` — tool-level proxy (`/api/v2/mcp/remote/*`).
15
+ *
16
+ * Неудачный relay **всегда** деградирует в `tools` (с причиной в статусе) —
17
+ * отказа и «тихого» исчезновения сервера нет.
18
+ */
19
+ export declare const MCP_REMOTE_MODES: readonly ["auto", "relay", "tools"];
20
+ export type McpRemoteMode = (typeof MCP_REMOTE_MODES)[number];
9
21
  /** Автор записи реестра (кто добавил сервер). */
10
22
  export interface McpRegistryAuthor {
11
23
  userId: string;
@@ -38,6 +50,11 @@ export interface McpRegistryEntry {
38
50
  * изменение не влияет на ранее созданные проекты/сессии.
39
51
  */
40
52
  enabledByDefault: boolean;
53
+ /**
54
+ * PROP-125: как доставлять сервер в локальные сессии гибрида.
55
+ * Отсутствие поля = `auto` (записи, созданные до PROP-125).
56
+ */
57
+ remoteMode?: McpRemoteMode;
41
58
  createdAt: string;
42
59
  updatedAt: string;
43
60
  }
@@ -148,12 +165,26 @@ export interface McpServerEffective {
148
165
  connected?: boolean;
149
166
  origin: McpRegistryOrigin;
150
167
  trust: McpRegistryTrust;
168
+ /**
169
+ * PROP-125: источник для UI — локальный инстанс или сервер гибрида.
170
+ * Не путать с `origin` (про реестр записи: instance/user).
171
+ */
172
+ source?: 'local' | 'server';
151
173
  /**
152
174
  * ADR-071 §2.2/§2.6: транспортный статус для таблицы «MCP» в статистике:
153
175
  * `disabled` — выключен в эффективном наборе, `connected`/`error`/`circuit-open`
154
176
  * — состояние подключения активного сервера.
155
177
  */
156
178
  status?: 'connected' | 'error' | 'disabled' | 'circuit-open';
179
+ /**
180
+ * PROP-125: причина недоступности/деградации сервера (без секретов).
181
+ *
182
+ * Для серверных MCP-серверов гибрида — причина, по которой сервер не
183
+ * работает: backend офлайн, сервер упал или relay не поднялся и клиент
184
+ * деградировал в режим `tools`. Для локальных серверов поле отсутствует —
185
+ * ошибки там не ведутся.
186
+ */
187
+ error?: string;
157
188
  /** ADR-071 §2.5/§2.6: автор записи реестра (null для instance/config-серверов). */
158
189
  author?: McpRegistryAuthor | null;
159
190
  /** ADR-071 §2.2/§2.6: имена инструментов сервера (пусто, если не подключён). */
@@ -167,6 +198,65 @@ export interface McpServerEffective {
167
198
  /** ADR-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
168
199
  toolDetails?: McpToolDetail[];
169
200
  }
201
+ /**
202
+ * PROP-125: вложение в результате удалённого MCP-вызова (base64, как в
203
+ * протоколе исполнителя 5 — ADR-077).
204
+ */
205
+ export interface McpRemoteAttachment {
206
+ mime: string;
207
+ name?: string;
208
+ base64: string;
209
+ }
210
+ /**
211
+ * PROP-125: описание серверного MCP-сервера для локального клиента.
212
+ *
213
+ * Секреты и URL с креденшелами в выдачу не попадают (ADR-105).
214
+ */
215
+ export interface RemoteMcpServerInfo {
216
+ name: string;
217
+ type: 'stdio' | 'sse' | 'http';
218
+ origin: 'instance' | 'user';
219
+ trust: McpRegistryTrust;
220
+ /** Системный мастер-флаг (hard-gate): `false` — сервер недоступен нигде. */
221
+ enabled: boolean;
222
+ /** «Включён по умолчанию для новых проектов» (сид `project.mcp`). */
223
+ enabledByDefault: boolean;
224
+ /** Фактический режим доставки в локальные сессии (PROP-125). */
225
+ remoteMode: McpRemoteMode;
226
+ status: 'idle' | 'up' | 'down';
227
+ toolCount: number;
228
+ error?: string;
229
+ instructions?: string;
230
+ }
231
+ /** PROP-125: описание одного инструмента удалённого MCP-сервера. */
232
+ export interface RemoteMcpToolInfo {
233
+ server: string;
234
+ name: string;
235
+ description: string;
236
+ inputSchema: Record<string, unknown>;
237
+ }
238
+ /** PROP-125: ответ `GET /api/v2/mcp/remote/tools?server=…`. */
239
+ export interface RemoteMcpToolsResponse {
240
+ server: string;
241
+ instructions?: string;
242
+ tools: RemoteMcpToolInfo[];
243
+ }
244
+ /** PROP-125: тело `POST /api/v2/mcp/remote/call`. */
245
+ export interface RemoteMcpCallRequest {
246
+ server: string;
247
+ tool: string;
248
+ arguments?: Record<string, unknown>;
249
+ meta?: Record<string, unknown>;
250
+ }
251
+ /**
252
+ * PROP-125: результат удалённого MCP-вызова — тот же шейп, что у протокола
253
+ * исполнителя 5 (`docs/EXECUTION.md`): один формат на два «MCP вне процесса».
254
+ */
255
+ export interface RemoteMcpCallResult {
256
+ content: string;
257
+ isError: boolean;
258
+ attachments?: McpRemoteAttachment[];
259
+ }
170
260
  /**
171
261
  * Машинно-читаемый код ошибки записи реестра MCP с plaintext-секретом
172
262
  * в заголовках (ADR-105 §5, Ф3).
package/dist/types/mcp.js CHANGED
@@ -3,6 +3,17 @@
3
3
  export const MCP_REGISTRY_SCHEMA_VERSION = 1;
4
4
  export const MCP_REGISTRY_ORIGINS = ['instance', 'user'];
5
5
  export const MCP_REGISTRY_TRUST_LEVELS = ['builtin', 'community'];
6
+ /**
7
+ * PROP-125: режим доставки серверного MCP-сервера в локальные сессии гибрида.
8
+ *
9
+ * - `auto` — `relay` для `http`/`sse`, `tools` для `stdio` (дефолт);
10
+ * - `relay` — полноценный MCP-клиент через backend (`/api/v2/mcp/relay/:name`);
11
+ * - `tools` — tool-level proxy (`/api/v2/mcp/remote/*`).
12
+ *
13
+ * Неудачный relay **всегда** деградирует в `tools` (с причиной в статусе) —
14
+ * отказа и «тихого» исчезновения сервера нет.
15
+ */
16
+ export const MCP_REMOTE_MODES = ['auto', 'relay', 'tools'];
6
17
  export const MCP_NETWORK_POLICY_MODES = ['allow', 'deny'];
7
18
  /**
8
19
  * Служебные/специальные адресные диапазоны, запрещённые по умолчанию (SSRF/egress).
@@ -0,0 +1,96 @@
1
+ /**
2
+ * ADR-126 §2/§2: контракты «поверхности ввода» — упоминания (`@`), скиллы
3
+ * (`$`) и сниппеты (`#`).
4
+ *
5
+ * Модуль **browser-safe** (без `node:*`): типы читают и ядро (парсер
6
+ * `engine/input-surface/parser.ts`), и UI (подсветка токенов в композере).
7
+ * Разбор текста живёт в core — здесь только контракты (ADR-095: типы в shared).
8
+ */
9
+ /** Вид упоминания сущности: файл, агент или пользователь. */
10
+ export type MentionKind = 'file' | 'agent' | 'user';
11
+ /**
12
+ * Позиция токена в исходном тексте: 0-based, `end` — **exclusive**.
13
+ * Индексы — в единицах UTF-16 (как индексы JS-строки), `text.slice` по ним
14
+ * даёт ровно исходный токен.
15
+ */
16
+ export interface MentionSpan {
17
+ start: number;
18
+ end: number;
19
+ }
20
+ /** Упоминание сущности (`@`). */
21
+ export interface InputMention {
22
+ /**
23
+ * Вид упоминания. На этапе лексики (`core/engine/input-surface/parser.ts`)
24
+ * вид выводится по форме токена: путь (`/` или `.`) — `file`, иначе `agent`.
25
+ * Окончательное разрешение (в т.ч. `@user`) — задача позднего резолвера
26
+ * (ADR-126 §2).
27
+ */
28
+ kind: MentionKind;
29
+ /** Нормализованный идентификатор: без префикса и без завершающей пунктуации. */
30
+ id: string;
31
+ /** Текст без префикса — как его набрал пользователь (может отличаться от `id`). */
32
+ label: string;
33
+ /** Границы токена в исходном тексте (включают префикс). */
34
+ span: MentionSpan;
35
+ }
36
+ /** Явный вызов скилла (`$`). */
37
+ export interface SkillMention {
38
+ /** Имя скилла (без префикса и без завершающей пунктуации). */
39
+ id: string;
40
+ /** Текст без префикса — как его набрал пользователь. */
41
+ label: string;
42
+ span: MentionSpan;
43
+ }
44
+ /** Ссылка на сниппет (`#`). */
45
+ export interface SnippetMention {
46
+ /** Имя сниппета (без префикса и без завершающей пунктуации). */
47
+ id: string;
48
+ /** Текст без префикса — как его набрал пользователь. */
49
+ label: string;
50
+ span: MentionSpan;
51
+ }
52
+ /**
53
+ * Вызов объявленного скрипта проекта (`!`) — ADR-126 §5.
54
+ *
55
+ * Образуется **только** первым непробельным токеном сообщения: `!` в
56
+ * середине текста — обычный символ (ADR-126 §5 «первый непробельный токен»).
57
+ */
58
+ export interface ScriptRunMention {
59
+ /** Имя скрипта: `[a-z0-9][a-z0-9-]*` (без префикса `!`). */
60
+ name: string;
61
+ /**
62
+ * Сырые аргументы — остаток строки после имени (без разбора кавычек:
63
+ * разбор делает лексер аргументов скрипта, `splitScriptArguments`).
64
+ */
65
+ args: string;
66
+ }
67
+ /** Результат разбора пользовательского текста. */
68
+ export interface ParsedInput {
69
+ /** Исходный текст без изменений: префиксы и экранирование сохранены. */
70
+ text: string;
71
+ /** Упоминания `@` в порядке появления. */
72
+ mentions: InputMention[];
73
+ /** Вызовы скиллов `$` в порядке появления. */
74
+ skills: SkillMention[];
75
+ /** Ссылки на сниппеты `#` в порядке появления. */
76
+ snippets: SnippetMention[];
77
+ /**
78
+ * Вызов скрипта `!name [args]` — ADR-126 §5.
79
+ *
80
+ * Поле **отсутствует**, если сообщение не начинается с `!`-токена
81
+ * (например `сделай !dev` — обычный текст).
82
+ */
83
+ scriptRun?: ScriptRunMention;
84
+ }
85
+ /** Род токена ввода. */
86
+ export type InputTokenKind = 'mention' | 'skill' | 'snippet';
87
+ /**
88
+ * Плоский вид токена ввода (упоминание/скилл/сниппет в одном списке) — для
89
+ * подсветки и чипов в композере UI.
90
+ */
91
+ export interface InputToken {
92
+ kind: InputTokenKind;
93
+ id: string;
94
+ label: string;
95
+ span: MentionSpan;
96
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * ADR-126 §2/§2: контракты «поверхности ввода» — упоминания (`@`), скиллы
3
+ * (`$`) и сниппеты (`#`).
4
+ *
5
+ * Модуль **browser-safe** (без `node:*`): типы читают и ядро (парсер
6
+ * `engine/input-surface/parser.ts`), и UI (подсветка токенов в композере).
7
+ * Разбор текста живёт в core — здесь только контракты (ADR-095: типы в shared).
8
+ */
9
+ export {};