@itphx/synth-shared 0.11.3 → 0.12.4

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 (92) hide show
  1. package/dist/config/defaults.js +126 -3
  2. package/dist/config/env-overrides.d.ts +29 -0
  3. package/dist/config/env-overrides.js +155 -2
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +1 -0
  7. package/dist/config/index.js +1 -0
  8. package/dist/config/proxy.js +3 -1
  9. package/dist/config/resolve.d.ts +8 -8
  10. package/dist/config/resolve.js +7 -7
  11. package/dist/config/types.d.ts +1287 -4037
  12. package/dist/config/types.js +461 -68
  13. package/dist/i18n/index.d.ts +1 -1
  14. package/dist/i18n/index.js +277 -0
  15. package/dist/index.d.ts +14 -2
  16. package/dist/index.js +16 -2
  17. package/dist/model-metadata.d.ts +10 -0
  18. package/dist/schemas/index.d.ts +980 -2322
  19. package/dist/schemas/index.js +183 -22
  20. package/dist/types/analytics.d.ts +6 -6
  21. package/dist/types/analytics.js +4 -4
  22. package/dist/types/authority.d.ts +464 -0
  23. package/dist/types/authority.js +445 -0
  24. package/dist/types/background.d.ts +96 -0
  25. package/dist/types/background.js +24 -0
  26. package/dist/types/bus-events.d.ts +23 -1
  27. package/dist/types/catalog.d.ts +349 -0
  28. package/dist/types/catalog.js +393 -0
  29. package/dist/types/decision.d.ts +28 -337
  30. package/dist/types/egress.d.ts +1 -1
  31. package/dist/types/egress.js +1 -1
  32. package/dist/types/events.d.ts +54 -1
  33. package/dist/types/external-credentials.d.ts +352 -0
  34. package/dist/types/external-credentials.js +200 -0
  35. package/dist/types/hooks.d.ts +33 -12
  36. package/dist/types/index.d.ts +20 -0
  37. package/dist/types/index.js +50 -1
  38. package/dist/types/llm-filters.d.ts +150 -0
  39. package/dist/types/llm-filters.js +54 -0
  40. package/dist/types/mcp.d.ts +33 -2
  41. package/dist/types/mcp.js +44 -1
  42. package/dist/types/message.d.ts +45 -1
  43. package/dist/types/pack.d.ts +1102 -0
  44. package/dist/types/pack.js +1003 -0
  45. package/dist/types/permission.d.ts +25 -11
  46. package/dist/types/permission.js +1 -1
  47. package/dist/types/pipeline-engine.d.ts +453 -0
  48. package/dist/types/pipeline-engine.js +440 -0
  49. package/dist/types/pipeline.d.ts +275 -0
  50. package/dist/types/pipeline.js +212 -0
  51. package/dist/types/plugin-audit.d.ts +110 -0
  52. package/dist/types/plugin-audit.js +185 -0
  53. package/dist/types/plugin-hybrid.d.ts +85 -0
  54. package/dist/types/plugin-hybrid.js +68 -0
  55. package/dist/types/plugin-lock.d.ts +95 -0
  56. package/dist/types/plugin-lock.js +1 -0
  57. package/dist/types/plugin-protocol.d.ts +221 -0
  58. package/dist/types/plugin-protocol.js +322 -0
  59. package/dist/types/plugin-runtime.d.ts +25 -0
  60. package/dist/types/plugin-runtime.js +11 -0
  61. package/dist/types/plugin-scan.d.ts +159 -0
  62. package/dist/types/plugin-scan.js +166 -0
  63. package/dist/types/plugin-tools.d.ts +51 -0
  64. package/dist/types/plugin-tools.js +72 -0
  65. package/dist/types/project.d.ts +14 -0
  66. package/dist/types/prompt-blocks.d.ts +102 -0
  67. package/dist/types/prompt-blocks.js +24 -0
  68. package/dist/types/prompt.d.ts +45 -3
  69. package/dist/types/provider.d.ts +11 -0
  70. package/dist/types/question.d.ts +153 -0
  71. package/dist/types/question.js +65 -0
  72. package/dist/types/schedules.d.ts +26 -3
  73. package/dist/types/semver.d.ts +48 -0
  74. package/dist/types/semver.js +218 -0
  75. package/dist/types/service-keys.d.ts +41 -3
  76. package/dist/types/service-keys.js +44 -2
  77. package/dist/types/session.d.ts +54 -0
  78. package/dist/types/steering.d.ts +74 -0
  79. package/dist/types/steering.js +75 -0
  80. package/dist/types/tools.d.ts +125 -5
  81. package/dist/types/tools.js +75 -0
  82. package/dist/types/trust.d.ts +31 -0
  83. package/dist/types/trust.js +27 -0
  84. package/dist/types/worktree.d.ts +170 -0
  85. package/dist/types/worktree.js +101 -0
  86. package/dist/utils/index.d.ts +31 -1
  87. package/dist/utils/index.js +92 -12
  88. package/dist/utils/reasoning.d.ts +16 -0
  89. package/dist/utils/reasoning.js +37 -0
  90. package/dist/version.d.ts +1 -1
  91. package/dist/version.js +1 -1
  92. package/package.json +2 -2
@@ -1,6 +1,10 @@
1
1
  export * from './message.js';
2
2
  export * from './session.js';
3
3
  export * from './prompt.js';
4
+ export * from './prompt-blocks.js';
5
+ export * from './llm-filters.js';
6
+ export * from './plugin-tools.js';
7
+ export * from './plugin-protocol.js';
4
8
  export * from './mcp.js';
5
9
  export * from './project.js';
6
10
  export * from './git.js';
@@ -9,6 +13,7 @@ export * from './agent.js';
9
13
  export * from './provider.js';
10
14
  export * from './llm.js';
11
15
  export * from './bus-events.js';
16
+ export * from './steering.js';
12
17
  export * from './fs.js';
13
18
  export * from './tools.js';
14
19
  export * from './permission.js';
@@ -20,6 +25,21 @@ export * from './schedules.js';
20
25
  export * from './decision.js';
21
26
  export * from './service-keys.js';
22
27
  export * from './webhooks.js';
28
+ export * from './external-credentials.js';
23
29
  export * from './maintenance.js';
24
30
  export * from './egress.js';
25
31
  export * from './analytics.js';
32
+ export * from './pack.js';
33
+ export * from './semver.js';
34
+ export * from './plugin-audit.js';
35
+ export * from './plugin-scan.js';
36
+ export * from './plugin-lock.js';
37
+ export * from './plugin-runtime.js';
38
+ export * from './plugin-hybrid.js';
39
+ export * from './catalog.js';
40
+ export * from './authority.js';
41
+ export * from './pipeline.js';
42
+ export * from './pipeline-engine.js';
43
+ export * from './question.js';
44
+ export * from './background.js';
45
+ export * from './worktree.js';
@@ -8,6 +8,14 @@ export * from './message.js';
8
8
  export * from './session.js';
9
9
  // Промпт: состояние/манифест/история (ADR-070/071)
10
10
  export * from './prompt.js';
11
+ // ADR-090: контракт провайдера блока системного промпта
12
+ export * from './prompt-blocks.js';
13
+ // ADR-090: контракт фильтра LLM-вызовов
14
+ export * from './llm-filters.js';
15
+ // ADR-090: namespace инструментов плагина (plugin_<ns>_<tool>)
16
+ export * from './plugin-tools.js';
17
+ // ADR-090: wire-протокол плагина (версия, DTO, эндпоинты, коды)
18
+ export * from './plugin-protocol.js';
11
19
  // MCP: реестр серверов, сетевой доступ, уровни/эффективный набор (ADR-071)
12
20
  export * from './mcp.js';
13
21
  // Проекты, workspace-политика, иконки/цвета, план (ADR-039/075)
@@ -24,6 +32,8 @@ export * from './provider.js';
24
32
  export * from './llm.js';
25
33
  // EventType/BusEvent — шина событий сессии (ADR-009/024)
26
34
  export * from './bus-events.js';
35
+ // ADR-104: режимы отправки сообщения во время хода (steering)
36
+ export * from './steering.js';
27
37
  // Файловая система (FS API v2)
28
38
  export * from './fs.js';
29
39
  // --- Реэкспорт существующих доменных модулей ---
@@ -47,9 +57,48 @@ export * from './decision.js';
47
57
  export * from './service-keys.js';
48
58
  // ADR-052 (этап II): исходящие webhooks — типы и матчер событий — re-exported from webhooks.ts
49
59
  export * from './webhooks.js';
60
+ // ADR-105 (Ф0): внешний доступ к внешним сервисам (коннекторам) — типы, zod и
61
+ // маппер «метаданные без секрета».
62
+ export * from './external-credentials.js';
50
63
  // ADR-092 (остаток): аудит-журнал обслуживания инстанса — re-exported from maintenance.ts
51
64
  export * from './maintenance.js';
52
65
  // Egress-политика, журнал внешних запросов и аудит security-политик
53
66
  export * from './egress.js';
54
- // Аналитика и отчётность инстанса: суточные роллапы (PROP-102)
67
+ // Аналитика и отчётность инстанса: суточные роллапы (ADR-102)
55
68
  export * from './analytics.js';
69
+ // ADR-086/ADR-090: единый манифест расширения `synth.pack` — типы и zod-схемы
70
+ export * from './pack.js';
71
+ // ADR-090: semver-матчер диапазонов версий (host/контракты расширения)
72
+ export * from './semver.js';
73
+ // ADR-090: журнал аудита плагинов — отдельный тип и отдельный scope
74
+ // (не расширение `SECURITY_AUDIT_SCOPES` — семантика «событие расширения»).
75
+ export * from './plugin-audit.js';
76
+ // PROP-068 §4.2/§4.3 + ADR-090: контракты сканера расширений (категории,
77
+ // severity→verdict, квоты), матрица install-policy и запись lock-файла.
78
+ export * from './plugin-scan.js';
79
+ // PROP-068 §4.4 / ADR-090: запись lock-файла плагинов (`plugins.lock.json`).
80
+ export * from './plugin-lock.js';
81
+ // ADR-090: runtime-override плагинов (`plugins.json`).
82
+ export * from './plugin-runtime.js';
83
+ // ADR-090 Ф7: контракт гибридной политики плагинов (сигнал дискавери,
84
+ // allow-list, статусы проверки сервером, заголовок `plugin_id`).
85
+ export * from './plugin-hybrid.js';
86
+ // PROP-068 §3/§12: контракт индекса каталога расширений (format: 1) — типы, zod-схемы, tolerant-парсер
87
+ export * from './catalog.js';
88
+ // ADR-106 Ф0: модель Authority-слоя — полномочия пользователей и агентов
89
+ // как контент (Principal/Action/Target/Grant/Role/Ceiling/Turn/Approval).
90
+ export * from './authority.js';
91
+ // ADR-051/ADR-100: контракт пайплайна (определение, шаг, экземпляр)
92
+ export * from './pipeline.js';
93
+ // ADR-101: контракты пайплайна как второго движка (спецификация, узлы,
94
+ // переходы, триггер, результат узла, прогон, журнал) — re-exported from pipeline-engine.ts
95
+ export * from './pipeline-engine.js';
96
+ // Этап 1 roadmap 0.13: «вопрос пользователю» (ask_user) — типы записи вопроса
97
+ // + Zod-схемы HTTP-входа (ответа/отмены).
98
+ export * from './question.js';
99
+ // Этап 1 roadmap 0.13: единый реестр фоновых прогонов (фоновые саб-агенты и
100
+ // шелл-процессы) — типы записи и фильтра выборки.
101
+ export * from './background.js';
102
+ // Этап 1 roadmap 0.13 (блок 1.4): git worktrees — per-session рабочий каталог
103
+ // (ADR-114): тип записи, тела HTTP-входа и привязка сессии.
104
+ export * from './worktree.js';
@@ -0,0 +1,150 @@
1
+ /**
2
+ * ADR-090: контракт фильтра LLM-вызовов.
3
+ *
4
+ * Модуль browser-safe (только типы и чистые функции) — его используют и ядро
5
+ * (`GatewayProvider`), и будущий пакет `@itphx/synth-plugin`.
6
+ *
7
+ * **Границы контракта.**
8
+ * - Вход фильтра — **узкий DTO**: ни портов, ни функций, ни внутренних полей
9
+ * сообщений (как `PromptBlockContext` в точке `promptBlocks`).
10
+ * - Тип сообщения — `LlmFilterMessage`, а не `LLMMessage` из core
11
+ * (`packages/core/src/providers/base.ts`): контракт живёт в `shared`, а
12
+ * `LLMMessage` — внутренний тип ядра с полями служебного назначения
13
+ * (`branchId`/`pinned`/`usage`). Дублировать `LLMMessage` в `shared` нельзя —
14
+ * он разошёлся бы с ядром; поэтому фильтр видит только роль и текст.
15
+ * - Поведение при сбое/таймауте задаёт `failMode`; **по умолчанию** — по
16
+ * классу фильтра: блокирующий (`closed`) — наблюдательный (`open`).
17
+ * - **Право вето — только у доверенных**: фильтр с trust ниже `trusted` не
18
+ * может заблокировать или переписать вызов — хост понижает его вердикт до
19
+ * `allow` (ADR-090).
20
+ */
21
+ import type { TokenUsage } from './llm.js';
22
+ /**
23
+ * Фазы фильтра LLM-вызовов.
24
+ *
25
+ * - `pre_request` — до отправки запроса провайдеру (запрос уже обфусцирован);
26
+ * - `post_response` — после ответа провайдера (наблюдение: буферизация ответа
27
+ * запрещена, ADR-036);
28
+ * - `embedding` — перед вызовом эмбеддинга.
29
+ */
30
+ export declare const LLM_FILTER_PHASES: readonly ["pre_request", "post_response", "embedding"];
31
+ export type LlmFilterPhase = (typeof LLM_FILTER_PHASES)[number];
32
+ /**
33
+ * Поведение фильтра при сбое/таймауте:
34
+ * - `closed` — вызов **не уходит** провайдеру (fail-closed);
35
+ * - `open` — вызов идёт как есть (fail-open), факт сбоя — в аудите.
36
+ */
37
+ export declare const LLM_FILTER_FAIL_MODES: readonly ["open", "closed"];
38
+ export type LlmFilterFailMode = (typeof LLM_FILTER_FAIL_MODES)[number];
39
+ /**
40
+ * Вердикт фильтра:
41
+ * - `allow` — пропустить вызов;
42
+ * - `deny` — заблокировать вызов (вызов не уходит провайдеру);
43
+ * - `redact` — заменить содержимое (`post_response`/`embedding`).
44
+ */
45
+ export declare const LLM_FILTER_VERDICTS: readonly ["allow", "deny", "redact"];
46
+ export type LlmFilterVerdictKind = (typeof LLM_FILTER_VERDICTS)[number];
47
+ /**
48
+ * Сообщение запроса в виде узкого DTO (без служебных полей `LLMMessage`).
49
+ */
50
+ export interface LlmFilterMessage {
51
+ /** Роль сообщения (`user`/`assistant`/`system`/`tool`). */
52
+ readonly role: string;
53
+ /** Текст сообщения. */
54
+ readonly content: string;
55
+ /** Вызовы инструментов сообщения (структура провайдера — как есть). */
56
+ readonly toolCalls?: readonly Record<string, unknown>[];
57
+ }
58
+ /**
59
+ * Вход фильтра — узкий DTO (без портов и функций).
60
+ *
61
+ * Поля по фазам:
62
+ * - `pre_request`: `messages`/`systemPrompt`/`tools`;
63
+ * - `post_response`: `content`/`usage`;
64
+ * - `embedding`: `texts`.
65
+ */
66
+ export interface LlmFilterInput {
67
+ /** Фаза, в которой вызван фильтр. */
68
+ readonly phase: LlmFilterPhase;
69
+ /** Имя провайдера. */
70
+ readonly provider: string;
71
+ /** Модель. */
72
+ readonly model: string;
73
+ /** Сессия (пусто — вызов вне сессии: пул провайдеров, суммаризация). */
74
+ readonly sessionId?: string;
75
+ /** `pre_request`: сообщения запроса (уже обфусцированные). */
76
+ readonly messages?: readonly LlmFilterMessage[];
77
+ /** `pre_request`: текст системного промпта. */
78
+ readonly systemPrompt?: string;
79
+ /** `pre_request`: описание инструментов. */
80
+ readonly tools?: readonly Record<string, unknown>[];
81
+ /** `post_response`: полный текст ответа. */
82
+ readonly content?: string;
83
+ /** `post_response`: расход токенов. */
84
+ readonly usage?: TokenUsage;
85
+ /** `embedding`: тексты, уходящие в эмбеддинг. */
86
+ readonly texts?: readonly string[];
87
+ }
88
+ /**
89
+ * Вердикт фильтра.
90
+ *
91
+ * `redactedContent` — только для `redact` в `post_response`, `redactedTexts` —
92
+ * только для `redact` в `embedding`.
93
+ */
94
+ export interface LlmFilterVerdict {
95
+ /** Вердикт. */
96
+ readonly verdict: LlmFilterVerdictKind;
97
+ /** Человекочитаемая причина (попадает в аудит и в текст ответа). */
98
+ readonly reason?: string;
99
+ /** Машиночитаемый код причины. */
100
+ readonly code?: string;
101
+ /** Новое содержимое ответа (`redact` в `post_response`). */
102
+ readonly redactedContent?: string;
103
+ /** Новые тексты (`redact` в `embedding`). */
104
+ readonly redactedTexts?: readonly string[];
105
+ }
106
+ /**
107
+ * Фильтр LLM-вызовов (точка расширения `llmFilters`).
108
+ *
109
+ * Идентификатор — `plugin:<pluginName>:<filterName>`: префикс проверяет хост
110
+ * (чужой плагин не может занять id другого).
111
+ */
112
+ export interface LlmCallFilter {
113
+ /** Идентификатор фильтра: `plugin:<pluginName>:<filterName>`. */
114
+ readonly id: string;
115
+ /** Фаза вызова фильтра. */
116
+ readonly phase: LlmFilterPhase;
117
+ /**
118
+ * Поведение при сбое/таймауте. Не задан — по классу фильтра:
119
+ * блокирующий (`closed`) / наблюдательный (`open`).
120
+ */
121
+ readonly failMode?: LlmFilterFailMode;
122
+ /** Бюджет времени на вызов фильтра, мс. Не задан — из политики плагинов. */
123
+ readonly timeoutMs?: number;
124
+ /** Проверка. Возвращает вердикт. */
125
+ inspect(input: LlmFilterInput): Promise<LlmFilterVerdict> | LlmFilterVerdict;
126
+ }
127
+ /**
128
+ * Бюджет времени на один вызов фильтра по умолчанию, мс
129
+ * (`plugins.llmFilterTimeoutMs` в конфиге).
130
+ *
131
+ * Единый источник истины для конфига (`config/defaults.ts`) и для хоста
132
+ * (реестр фильтров). Точное значение — вопрос владельца (ADR-090,
133
+ * «Бюджет времени фильтра»): механизм fail-closed/open реализован, число
134
+ * подтверждается отдельно.
135
+ */
136
+ export declare const DEFAULT_LLM_FILTER_TIMEOUT_MS = 1000;
137
+ /** Фаза — известное значение перечня. */
138
+ export declare function isLlmFilterPhase(value: unknown): value is LlmFilterPhase;
139
+ /** Режим отказа — известное значение перечня. */
140
+ export declare function isLlmFilterFailMode(value: unknown): value is LlmFilterFailMode;
141
+ /** Вердикт — известное значение перечня. */
142
+ export declare function isLlmFilterVerdictKind(value: unknown): value is LlmFilterVerdictKind;
143
+ /**
144
+ * Может ли фильтр в этой фазе **заблокировать** вызов.
145
+ *
146
+ * `post_response` — не может: блокировка/правка ответа требует буферизации,
147
+ * а ADR-036 прямо запрещает буферы и задержки. В первой волне фаза
148
+ * `post_response` — только наблюдение.
149
+ */
150
+ export declare function phaseCanBlock(phase: LlmFilterPhase): boolean;
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Фазы фильтра LLM-вызовов.
3
+ *
4
+ * - `pre_request` — до отправки запроса провайдеру (запрос уже обфусцирован);
5
+ * - `post_response` — после ответа провайдера (наблюдение: буферизация ответа
6
+ * запрещена, ADR-036);
7
+ * - `embedding` — перед вызовом эмбеддинга.
8
+ */
9
+ export const LLM_FILTER_PHASES = ['pre_request', 'post_response', 'embedding'];
10
+ /**
11
+ * Поведение фильтра при сбое/таймауте:
12
+ * - `closed` — вызов **не уходит** провайдеру (fail-closed);
13
+ * - `open` — вызов идёт как есть (fail-open), факт сбоя — в аудите.
14
+ */
15
+ export const LLM_FILTER_FAIL_MODES = ['open', 'closed'];
16
+ /**
17
+ * Вердикт фильтра:
18
+ * - `allow` — пропустить вызов;
19
+ * - `deny` — заблокировать вызов (вызов не уходит провайдеру);
20
+ * - `redact` — заменить содержимое (`post_response`/`embedding`).
21
+ */
22
+ export const LLM_FILTER_VERDICTS = ['allow', 'deny', 'redact'];
23
+ /**
24
+ * Бюджет времени на один вызов фильтра по умолчанию, мс
25
+ * (`plugins.llmFilterTimeoutMs` в конфиге).
26
+ *
27
+ * Единый источник истины для конфига (`config/defaults.ts`) и для хоста
28
+ * (реестр фильтров). Точное значение — вопрос владельца (ADR-090,
29
+ * «Бюджет времени фильтра»): механизм fail-closed/open реализован, число
30
+ * подтверждается отдельно.
31
+ */
32
+ export const DEFAULT_LLM_FILTER_TIMEOUT_MS = 1000;
33
+ /** Фаза — известное значение перечня. */
34
+ export function isLlmFilterPhase(value) {
35
+ return LLM_FILTER_PHASES.includes(value);
36
+ }
37
+ /** Режим отказа — известное значение перечня. */
38
+ export function isLlmFilterFailMode(value) {
39
+ return LLM_FILTER_FAIL_MODES.includes(value);
40
+ }
41
+ /** Вердикт — известное значение перечня. */
42
+ export function isLlmFilterVerdictKind(value) {
43
+ return LLM_FILTER_VERDICTS.includes(value);
44
+ }
45
+ /**
46
+ * Может ли фильтр в этой фазе **заблокировать** вызов.
47
+ *
48
+ * `post_response` — не может: блокировка/правка ответа требует буферизации,
49
+ * а ADR-036 прямо запрещает буферы и задержки. В первой волне фаза
50
+ * `post_response` — только наблюдение.
51
+ */
52
+ export function phaseCanBlock(phase) {
53
+ return phase === 'pre_request' || phase === 'embedding';
54
+ }
@@ -1,6 +1,6 @@
1
1
  import type { McpServerConfig } from '../config/types.js';
2
2
  import type { McpToolDetail } from './prompt.js';
3
- /** Версия схемы записи реестра MCP — для будущей миграции (PROP-032). */
3
+ /** Версия схемы записи реестра MCP — для будущей миграции (ADR-096). */
4
4
  export declare const MCP_REGISTRY_SCHEMA_VERSION = 1;
5
5
  export declare const MCP_REGISTRY_ORIGINS: readonly ["instance", "user"];
6
6
  export type McpRegistryOrigin = (typeof MCP_REGISTRY_ORIGINS)[number];
@@ -14,7 +14,7 @@ export interface McpRegistryAuthor {
14
14
  /**
15
15
  * ADR-071 §2.5: плоская запись единого реестра MCP-серверов.
16
16
  *
17
- * Логическая модель сразу проектируется под PostgreSQL (PROP-032): стабильный
17
+ * Логическая модель сразу проектируется под PostgreSQL (ADR-097): стабильный
18
18
  * `id`, `schemaVersion`, timestamps; вложенность ограничена `config`/`author`
19
19
  * (раскладываются в JSONB/отдельные колонки). Instance- и пользовательские
20
20
  * записи различаются полем `origin`, не отдельными реестрами.
@@ -167,3 +167,34 @@ export interface McpServerEffective {
167
167
  /** ADR-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
168
168
  toolDetails?: McpToolDetail[];
169
169
  }
170
+ /**
171
+ * Машинно-читаемый код ошибки записи реестра MCP с plaintext-секретом
172
+ * в заголовках (ADR-105 §5, Ф3).
173
+ *
174
+ * HTTP: `400` с `error.code = "MCP_SECRET_HEADER_FORBIDDEN"`.
175
+ */
176
+ export declare const MCP_SECRET_HEADER_ERROR_CODE = "MCP_SECRET_HEADER_FORBIDDEN";
177
+ /**
178
+ * Заголовки, значение которых — **секрет**. В реестре MCP (и в конфиге
179
+ * коннектора) им не место: токен лежит в слое внешних доступов
180
+ * (`ExternalCredential`, ADR-105), а коннектор ссылается на него по id
181
+ * (`auth: { kind: 'credential', credentialId }`).
182
+ *
183
+ * Сравнение — регистронезависимое (HTTP-заголовки нечувствительны к регистру).
184
+ */
185
+ export declare const FORBIDDEN_MCP_SECRET_HEADERS: readonly ["authorization", "proxy-authorization", "x-api-key", "cookie"];
186
+ export type ForbiddenMcpSecretHeader = (typeof FORBIDDEN_MCP_SECRET_HEADERS)[number];
187
+ /**
188
+ * Найти запрещённые (секретные) заголовки в словаре `headers`.
189
+ *
190
+ * Возвращает **исходные имена** заголовков (как их записал пользователь) —
191
+ * они уходят в сообщение об ошибке (значения — никогда).
192
+ */
193
+ export declare function findForbiddenMcpSecretHeaders(headers: Record<string, string> | undefined | null): string[];
194
+ /**
195
+ * Текст ошибки «секретный заголовок в коннекторе» — **единый** для слоя
196
+ * хранилища, HTTP-роутов (core/backend) и probe (ADR-105 §5, Ф3).
197
+ *
198
+ * Значений заголовков в тексте нет — только их имена.
199
+ */
200
+ export declare function mcpSecretHeaderErrorMessage(forbidden: string[]): string;
package/dist/types/mcp.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // --- MCP: реестр серверов и сетевой доступ (ADR-071 §2.3.1/§2.5) ---
2
- /** Версия схемы записи реестра MCP — для будущей миграции (PROP-032). */
2
+ /** Версия схемы записи реестра MCP — для будущей миграции (ADR-096). */
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'];
@@ -117,3 +117,46 @@ export const MCP_DISABLED_REASONS = [
117
117
  'session_optout',
118
118
  'not_default',
119
119
  ];
120
+ // --- ADR-105 (Ф3): запрет plaintext-секретов в заголовках MCP-коннектора ---
121
+ /**
122
+ * Машинно-читаемый код ошибки записи реестра MCP с plaintext-секретом
123
+ * в заголовках (ADR-105 §5, Ф3).
124
+ *
125
+ * HTTP: `400` с `error.code = "MCP_SECRET_HEADER_FORBIDDEN"`.
126
+ */
127
+ export const MCP_SECRET_HEADER_ERROR_CODE = 'MCP_SECRET_HEADER_FORBIDDEN';
128
+ /**
129
+ * Заголовки, значение которых — **секрет**. В реестре MCP (и в конфиге
130
+ * коннектора) им не место: токен лежит в слое внешних доступов
131
+ * (`ExternalCredential`, ADR-105), а коннектор ссылается на него по id
132
+ * (`auth: { kind: 'credential', credentialId }`).
133
+ *
134
+ * Сравнение — регистронезависимое (HTTP-заголовки нечувствительны к регистру).
135
+ */
136
+ export const FORBIDDEN_MCP_SECRET_HEADERS = [
137
+ 'authorization',
138
+ 'proxy-authorization',
139
+ 'x-api-key',
140
+ 'cookie',
141
+ ];
142
+ /**
143
+ * Найти запрещённые (секретные) заголовки в словаре `headers`.
144
+ *
145
+ * Возвращает **исходные имена** заголовков (как их записал пользователь) —
146
+ * они уходят в сообщение об ошибке (значения — никогда).
147
+ */
148
+ export function findForbiddenMcpSecretHeaders(headers) {
149
+ if (!headers)
150
+ return [];
151
+ const forbidden = new Set(FORBIDDEN_MCP_SECRET_HEADERS);
152
+ return Object.keys(headers).filter((name) => forbidden.has(name.trim().toLowerCase()));
153
+ }
154
+ /**
155
+ * Текст ошибки «секретный заголовок в коннекторе» — **единый** для слоя
156
+ * хранилища, HTTP-роутов (core/backend) и probe (ADR-105 §5, Ф3).
157
+ *
158
+ * Значений заголовков в тексте нет — только их имена.
159
+ */
160
+ export function mcpSecretHeaderErrorMessage(forbidden) {
161
+ return `Заголовки с секретами (${forbidden.join(', ')}) в MCP-коннекторе запрещены — используйте auth.kind='credential' (доступ к внешнему сервису)`;
162
+ }
@@ -1,5 +1,6 @@
1
1
  import type { TokenUsage } from './llm.js';
2
2
  import type { PromptMeta } from './prompt.js';
3
+ import type { AuthorityPrincipal } from './authority.js';
3
4
  export declare enum MessageRole {
4
5
  SYSTEM = "system",
5
6
  USER = "user",
@@ -10,7 +11,44 @@ export declare enum MessageRole {
10
11
  INFO = "info",
11
12
  ERROR = "error"
12
13
  }
13
- export type PartType = 'text' | 'tool_use' | 'tool_result' | 'reasoning' | 'session_reference';
14
+ /**
15
+ * Типы частей сообщения.
16
+ *
17
+ * ADR-115: к текстовым/служебным добавлены медиа-типы (`image`/`audio`/
18
+ * `video`/`file`) — вложения сообщений. Текстовые части не меняются
19
+ * (обратная совместимость).
20
+ */
21
+ export type PartType = 'text' | 'tool_use' | 'tool_result' | 'reasoning' | 'session_reference' | 'image' | 'audio' | 'video' | 'file';
22
+ /** Медиа-типы части сообщения (ADR-115) — вложение. */
23
+ export type MediaPartType = 'image' | 'audio' | 'video' | 'file';
24
+ /**
25
+ * ADR-115 §«Модель контента»: данные медиа-части — ссылка на blob в
26
+ * blob-хранилище + метаданные. Байты в сообщении не лежат (том, ADR-116),
27
+ * поэтому часть переносима и переживает пересборку бэкапа.
28
+ */
29
+ export interface MediaPartData {
30
+ /** Путь объекта в blob-хранилище (`attachments/<sha2>/<sha256>`). */
31
+ blobPath: string;
32
+ /** SHA-256 содержимого (content-addressed, дедуп/GC). */
33
+ sha256: string;
34
+ /** MIME-тип по содержимому. */
35
+ mime: string;
36
+ /** Размер в байтах. */
37
+ size: number;
38
+ /** Имя файла (санитайз; в `blobPath` не входит). */
39
+ name?: string;
40
+ /** Ширина изображения/кадра, px. */
41
+ width?: number;
42
+ /** Высота изображения/кадра, px. */
43
+ height?: number;
44
+ /** Длительность аудио/видео, мс. */
45
+ durationMs?: number;
46
+ /**
47
+ * Текстовая расшифровка (ASR/OCR/извлечение из документа) — подставляется
48
+ * в контекст вместо байтов.
49
+ */
50
+ transcript?: string;
51
+ }
14
52
  export interface Part {
15
53
  id: string;
16
54
  type: PartType;
@@ -53,6 +91,12 @@ export interface Message {
53
91
  reasoning?: string;
54
92
  source?: 'web' | 'cli' | 'api';
55
93
  author?: string;
94
+ /**
95
+ * ADR-106 Ф0: принципал ввода (аддитивное поле). `author` остаётся
96
+ * display-строкой для UI — принципал даёт машиночитаемую атрибуцию
97
+ * («кто это сделал») без изменения существующих потребителей.
98
+ */
99
+ principal?: AuthorityPrincipal;
56
100
  agentRole?: string;
57
101
  metadata?: Record<string, unknown>;
58
102
  /** ADR-070 §2.4: предсказание/валидация prompt-cache для этого хода. */