@itphx/synth-shared 0.12.4 → 0.13.8

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 (67) hide show
  1. package/dist/config/defaults.js +125 -5
  2. package/dist/config/env-overrides.d.ts +23 -4
  3. package/dist/config/env-overrides.js +103 -4
  4. package/dist/config/index.d.ts +1 -0
  5. package/dist/config/index.js +1 -0
  6. package/dist/config/loader.d.ts +8 -0
  7. package/dist/config/loader.js +6 -1
  8. package/dist/config/redact.d.ts +22 -0
  9. package/dist/config/redact.js +53 -0
  10. package/dist/config/resolve.d.ts +17 -0
  11. package/dist/config/resolve.js +40 -1
  12. package/dist/config/tls.d.ts +7 -4
  13. package/dist/config/tls.js +10 -23
  14. package/dist/config/types.d.ts +496 -11
  15. package/dist/config/types.js +348 -6
  16. package/dist/i18n/index.d.ts +1 -1
  17. package/dist/i18n/index.js +317 -3
  18. package/dist/index.d.ts +4 -4
  19. package/dist/index.js +4 -4
  20. package/dist/model-metadata.d.ts +10 -0
  21. package/dist/model-metadata.js +10 -0
  22. package/dist/schemas/index.d.ts +378 -21
  23. package/dist/schemas/index.js +282 -5
  24. package/dist/types/agent.d.ts +8 -1
  25. package/dist/types/bus-events.d.ts +60 -2
  26. package/dist/types/egress.d.ts +2 -2
  27. package/dist/types/egress.js +2 -2
  28. package/dist/types/file-kind.d.ts +40 -0
  29. package/dist/types/file-kind.js +157 -0
  30. package/dist/types/fs.d.ts +54 -1
  31. package/dist/types/fs.js +43 -0
  32. package/dist/types/git.d.ts +88 -0
  33. package/dist/types/git.js +101 -1
  34. package/dist/types/host-pattern.d.ts +41 -0
  35. package/dist/types/host-pattern.js +143 -0
  36. package/dist/types/index.d.ts +4 -0
  37. package/dist/types/index.js +13 -1
  38. package/dist/types/llm.d.ts +95 -0
  39. package/dist/types/llm.js +58 -0
  40. package/dist/types/maintenance.d.ts +1 -1
  41. package/dist/types/mcp.d.ts +90 -0
  42. package/dist/types/mcp.js +11 -0
  43. package/dist/types/message-stream.d.ts +389 -0
  44. package/dist/types/message-stream.js +41 -0
  45. package/dist/types/message.d.ts +49 -0
  46. package/dist/types/pack.d.ts +6 -6
  47. package/dist/types/permission.d.ts +39 -3
  48. package/dist/types/pipeline-engine.d.ts +2 -2
  49. package/dist/types/project.d.ts +30 -0
  50. package/dist/types/project.js +16 -0
  51. package/dist/types/prompt.d.ts +4 -2
  52. package/dist/types/provider.d.ts +280 -0
  53. package/dist/types/provider.js +289 -0
  54. package/dist/types/service-keys.d.ts +6 -3
  55. package/dist/types/service-keys.js +6 -1
  56. package/dist/types/session.d.ts +178 -3
  57. package/dist/types/skills.d.ts +6 -0
  58. package/dist/types/tools.d.ts +57 -0
  59. package/dist/types/tools.js +49 -1
  60. package/dist/types/user.d.ts +7 -0
  61. package/dist/types/worktree.d.ts +1 -1
  62. package/dist/utils/index.js +1 -1
  63. package/dist/utils/reasoning.d.ts +18 -2
  64. package/dist/utils/reasoning.js +16 -7
  65. package/dist/version.d.ts +1 -1
  66. package/dist/version.js +1 -1
  67. package/package.json +4 -3
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, } from '../types/index.js';
2
+ import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, EFFORT_LEVELS, SSH_KEY_USAGES, MAX_SSH_ALLOW_HOSTS, MAX_SSH_ALLOW_PORTS, isValidHostRule, HOST_RULE_FORMAT_HINT, MARKDOWN_LIMITS, TODO_STATUSES, TODO_PRIORITIES, } from '../types/index.js';
3
3
  import { ToolCapability } from '../types/tools.js';
4
4
  /**
5
5
  * Экземпляр zod, которым построены **все** схемы этого пакета.
@@ -86,12 +86,58 @@ export function patchObjectSchema(schema) {
86
86
  }
87
87
  return z.object(patchShape);
88
88
  }
89
+ /**
90
+ * Instance-wide дефолты оптимизации контекста для новых сессий
91
+ * (`context.defaults`, runtime-override — `/api/v2/settings/context-defaults`).
92
+ *
93
+ * Значения по умолчанию совпадают с прежними литералами
94
+ * `SessionManager.createSession`: новая сессия без явных `settings` получает
95
+ * ровно те же настройки, что и до появления настройки инстанса.
96
+ */
97
+ export const contextDefaultsSchema = z.object({
98
+ // `sticky_notes` — legacy-значение сессий, в дефолтах и UI не предлагается:
99
+ // заметки работают независимо от стратегии оптимизации.
100
+ contextOptimization: z.enum(['none', 'sliding_window', 'summarization', 'compaction']).default('compaction'),
101
+ summarizationEnabled: z.boolean().default(true),
102
+ summarizationTriggerMode: z.enum(['messages', 'tokens']).default('messages'),
103
+ summarizeAfterN: z.number().int().min(1).default(10),
104
+ summarizeTokenThreshold: z.number().int().min(1).max(100).default(50),
105
+ /** @deprecated Новый движок сжатия не использует head/tail (см. `summarizationKeepTokens`). */
106
+ summarizationHeadMessages: z.number().int().min(1).default(2),
107
+ /** @deprecated См. `summarizationHeadMessages`. */
108
+ summarizationTailMessages: z.number().int().min(1).default(3),
109
+ summarizationKeepTokens: z.number().int().min(0).default(5000),
110
+ compactionKeepTokens: z.number().int().min(0).default(15000),
111
+ compactionTokenThreshold: z.number().int().min(1).max(100).default(85),
112
+ slidingWindowMode: z.enum(['messages', 'tokens']).default('messages'),
113
+ slidingWindowMessageLimit: z.number().int().min(1).default(10),
114
+ slidingWindowTokenThreshold: z.number().int().min(1).max(100).default(80),
115
+ });
116
+ /**
117
+ * Instance-wide лимиты заметок сессии (`context.stickyNotes`).
118
+ *
119
+ * Не дефолты сессии, а **ограничения инстанса**: применяются ко всем сессиям
120
+ * при создании/изменении заметки. Runtime-override —
121
+ * `/api/v2/settings/sticky-notes`. Значения по умолчанию совпадают с прежним
122
+ * поведением (заметки не ограничивались) и задают разумный верхний предел,
123
+ * чтобы заметки не превращались в бездонный канал контекста.
124
+ */
125
+ export const stickyNotesLimitsSchema = z.object({
126
+ maxCount: z.number().int().min(1).max(1000).default(50),
127
+ maxChars: z.number().int().min(1).max(100000).default(2000),
128
+ });
89
129
  export const sessionSettingsSchema = z.object({
90
130
  provider: z.string().optional(),
91
131
  model: z.string().optional(),
92
132
  reasoningLevel: z.enum(['default', 'none', 'low', 'medium', 'high']).optional(),
93
- temperature: z.number().min(0).max(2).default(0.7),
94
- maxTokens: z.number().int().min(1).max(200000).default(4096),
133
+ /**
134
+ * ADR-117: явный тир усилия (effort) — `xhigh`/`max` задаются только так.
135
+ * Невалидное значение → 400 (`VALIDATION_ERROR`), а не тихий игнор.
136
+ */
137
+ effort: z.enum(EFFORT_LEVELS).optional(),
138
+ // Без дефолта: `undefined` = дефолт модели (поле не отправляется провайдеру).
139
+ temperature: z.number().min(0).max(2).optional(),
140
+ maxTokens: z.number().int().min(0).max(200000).default(0),
95
141
  systemPrompt: z.string().optional(),
96
142
  debugEnabled: z.boolean().default(true),
97
143
  streamEnabled: z.boolean().default(true),
@@ -99,7 +145,7 @@ export const sessionSettingsSchema = z.object({
99
145
  // ADR-071 §2.4: сессионный скоуп MCP (явно включённые / opt-out).
100
146
  mcpServers: z.array(z.string()).optional(),
101
147
  mcpDisabledServers: z.array(z.string()).optional(),
102
- contextOptimization: z.enum(['none', 'sliding_window', 'summarization', 'sticky_notes']).default('none'),
148
+ contextOptimization: z.enum(['none', 'sliding_window', 'summarization', 'compaction', 'sticky_notes']).default('none'),
103
149
  slidingWindowMode: z.enum(['messages', 'tokens']).default('messages'),
104
150
  slidingWindowMessageLimit: z.number().int().min(1).default(10),
105
151
  slidingWindowTokenThreshold: z.number().int().min(10).max(100).default(80),
@@ -107,8 +153,13 @@ export const sessionSettingsSchema = z.object({
107
153
  summarizationTriggerMode: z.enum(['messages', 'tokens']).default('messages'),
108
154
  summarizeAfterN: z.number().int().min(1).default(10),
109
155
  summarizeTokenThreshold: z.number().int().min(10).max(100).default(50),
156
+ /** @deprecated Новый движок сжатия не использует head/tail (см. `summarizationKeepTokens`). */
110
157
  summarizationHeadMessages: z.number().int().min(1).default(2),
158
+ /** @deprecated См. `summarizationHeadMessages`. */
111
159
  summarizationTailMessages: z.number().int().min(1).default(3),
160
+ summarizationKeepTokens: z.number().int().min(0).default(5000),
161
+ compactionKeepTokens: z.number().int().min(0).default(15000),
162
+ compactionTokenThreshold: z.number().int().min(1).max(100).default(85),
112
163
  showInterview: z.boolean().default(true),
113
164
  websocketEnabled: z.boolean().default(true),
114
165
  language: z.string().optional(),
@@ -192,13 +243,50 @@ export const projectUpdateSchema = z.object({
192
243
  repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
193
244
  memory: projectMemoryUpdateSchema.optional(),
194
245
  });
195
- /** ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`). */
246
+ /**
247
+ * PROP-124: правило хоста в политике SSH-ключа.
248
+ *
249
+ * Семантика — общая с ADR-099 (`matchTlsHostPattern`/`isValidHostRule`):
250
+ * точный hostname, `*.suffix` (только поддомены), IP-литерал или CIDR.
251
+ * Одиночный `*` («любой хост») недопустим — fail-closed.
252
+ */
253
+ const sshHostRuleSchema = z
254
+ .string()
255
+ .max(253)
256
+ .refine((value) => isValidHostRule(value), {
257
+ message: `невалидный шаблон хоста: ${HOST_RULE_FORMAT_HINT}`,
258
+ });
259
+ /**
260
+ * ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`).
261
+ *
262
+ * PROP-124: дополнительно принимает `usages` (`git`/`ssh`), `allowHosts`
263
+ * (правила хостов) и `allowPorts` (порты 1..65535) — политику ключа для
264
+ * режима инстанса `tools`.
265
+ */
196
266
  export const sshKeyCreateSchema = z.object({
197
267
  name: z.string().min(1).max(200),
198
268
  type: z.string().optional(),
199
269
  privateKey: z.string().min(1),
200
270
  passphrase: z.string().optional(),
201
271
  agentIds: z.array(z.string()).optional(),
272
+ /**
273
+ * PROP-124: способы использования ключа (`git`/`ssh`).
274
+ *
275
+ * Пустой список **недопустим**: ключ без назначения бесполезен (не годится
276
+ * ни для git, ни для ssh) — это тихая ловушка, в которой можно застрять,
277
+ * сняв оба флажка. Если поле передано — в нём должно быть хотя бы одно
278
+ * значение (`400 VALIDATION_ERROR`).
279
+ */
280
+ usages: z
281
+ .array(z.enum(SSH_KEY_USAGES))
282
+ .min(1, {
283
+ message: `usages: нужен хотя бы один способ использования (${SSH_KEY_USAGES.join('|')})`,
284
+ })
285
+ .optional(),
286
+ /** PROP-124: правила хостов (режим `tools`); лимит — `MAX_SSH_ALLOW_HOSTS`. */
287
+ allowHosts: z.array(sshHostRuleSchema).max(MAX_SSH_ALLOW_HOSTS).optional(),
288
+ /** PROP-124: порты (режим `tools`); лимит — `MAX_SSH_ALLOW_PORTS`. */
289
+ allowPorts: z.array(z.number().int().min(1).max(65535)).max(MAX_SSH_ALLOW_PORTS).optional(),
202
290
  });
203
291
  /** ADR-076: тело обновления SSH-ключа (без id/createdAt). */
204
292
  export const sshKeyUpdateSchema = sshKeyCreateSchema.partial();
@@ -1000,3 +1088,192 @@ export const mediaPartSchema = z.object({
1000
1088
  durationMs: z.number().int().min(0).optional(),
1001
1089
  transcript: z.string().optional(),
1002
1090
  });
1091
+ // --- PROP-054: план (ADR-039), ToDo (ADR-039), журнал и инварианты проекта ---
1092
+ //
1093
+ // Контракт «план/ToDo/журнал» (PROP-054, дополнение 2026-11-07): у сущностей
1094
+ // есть Zod-схемы (в shared), а тела мутаций — **strict** (лишнее поле — ошибка
1095
+ // валидации, а не молчаливое игнорирование). При **чтении** (импорт/перенос
1096
+ // между мирами) допустим `passthrough` — старые записи могли нести поля,
1097
+ // которых больше нет в модели.
1098
+ /** Приоритет пункта плана (ADR-039). */
1099
+ export const PLAN_PRIORITIES = ['high', 'medium', 'low'];
1100
+ /** Отношение зависимости пункта плана (ADR-039). */
1101
+ export const PLAN_DEPENDENCY_RELATIONS = ['blocked_by', 'blocks', 'relates_to'];
1102
+ /** Зависимость пункта плана (ADR-039): `projectId` пуст = тот же проект. */
1103
+ export const planDependencySchema = z
1104
+ .object({
1105
+ projectId: z.string().optional(),
1106
+ itemId: z.string().min(1),
1107
+ relation: z.enum(PLAN_DEPENDENCY_RELATIONS),
1108
+ })
1109
+ .passthrough();
1110
+ /** Колонка плана (ADR-039) — статус пункта. */
1111
+ export const planColumnSchema = z
1112
+ .object({
1113
+ id: z.string().min(1),
1114
+ name: z.string().min(1).max(100),
1115
+ order: z.number().int(),
1116
+ wipLimit: z.number().int().min(0).optional(),
1117
+ })
1118
+ .passthrough();
1119
+ /** Пункт плана (ADR-039). `description` — Markdown (лимит `MARKDOWN_LIMITS`). */
1120
+ export const planItemSchema = z
1121
+ .object({
1122
+ id: z.string().min(1),
1123
+ title: z.string().min(1).max(500),
1124
+ description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
1125
+ columnId: z.string().min(1),
1126
+ priority: z.enum(PLAN_PRIORITIES),
1127
+ order: z.number().int(),
1128
+ dependsOn: z.array(planDependencySchema).default([]),
1129
+ tags: z.array(z.string()).optional(),
1130
+ createdAt: z.string(),
1131
+ updatedAt: z.string(),
1132
+ })
1133
+ .passthrough();
1134
+ /** План проекта целиком (ADR-039). */
1135
+ export const projectPlanSchema = z
1136
+ .object({
1137
+ version: z.number().int(),
1138
+ updatedAt: z.string(),
1139
+ columns: z.array(planColumnSchema),
1140
+ items: z.array(planItemSchema),
1141
+ })
1142
+ .passthrough();
1143
+ /** Пункт ToDo сессии (ADR-039). `content` — Markdown (лимит `MARKDOWN_LIMITS`). */
1144
+ export const todoItemSchema = z
1145
+ .object({
1146
+ id: z.string().min(1),
1147
+ content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent),
1148
+ status: z.enum(TODO_STATUSES),
1149
+ priority: z.enum(TODO_PRIORITIES),
1150
+ planItemId: z.string().optional(),
1151
+ })
1152
+ .passthrough();
1153
+ /** Запись журнала проекта (PROP-054): `updatedAt`/`updatedBy` — аддитивные. */
1154
+ export const projectLogEntrySchema = z
1155
+ .object({
1156
+ id: z.string().min(1),
1157
+ text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
1158
+ createdAt: z.string(),
1159
+ sessionId: z.string().optional(),
1160
+ author: z.string().optional(),
1161
+ updatedAt: z.string().optional(),
1162
+ updatedBy: z.string().optional(),
1163
+ })
1164
+ .passthrough();
1165
+ // --- Тела HTTP-мутаций плана (PROP-054) — strict ---
1166
+ /** Создание пункта плана. */
1167
+ export const planItemCreateSchema = z
1168
+ .object({
1169
+ title: z.string().min(1).max(500),
1170
+ description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
1171
+ columnId: z.string().min(1).optional(),
1172
+ priority: z.enum(PLAN_PRIORITIES).optional(),
1173
+ dependsOn: z.array(planDependencySchema).optional(),
1174
+ tags: z.array(z.string()).optional(),
1175
+ })
1176
+ .strict();
1177
+ /** Точечная правка полей пункта плана (версия не требуется). */
1178
+ export const planItemUpdateSchema = z
1179
+ .object({
1180
+ title: z.string().min(1).max(500).optional(),
1181
+ description: z.string().max(MARKDOWN_LIMITS.planDescription).optional(),
1182
+ priority: z.enum(PLAN_PRIORITIES).optional(),
1183
+ tags: z.array(z.string()).optional(),
1184
+ dependsOn: z.array(planDependencySchema).optional(),
1185
+ })
1186
+ .strict();
1187
+ /**
1188
+ * Перемещение пункта плана: `beforeItemId`/`afterItemId` — соседи-ориентиры
1189
+ * (упорядочивание без ручного `order`); `version` — оптимистичная блокировка.
1190
+ */
1191
+ export const planItemMoveSchema = z
1192
+ .object({
1193
+ columnId: z.string().min(1),
1194
+ beforeItemId: z.string().min(1).optional(),
1195
+ afterItemId: z.string().min(1).optional(),
1196
+ version: z.number().int().optional(),
1197
+ })
1198
+ .strict();
1199
+ /** Создание колонки плана. */
1200
+ export const planColumnCreateSchema = z
1201
+ .object({
1202
+ name: z.string().min(1).max(100),
1203
+ wipLimit: z.number().int().min(0).optional(),
1204
+ })
1205
+ .strict();
1206
+ /** Правка колонки плана (имя/WIP-лимит). */
1207
+ export const planColumnUpdateSchema = z
1208
+ .object({
1209
+ name: z.string().min(1).max(100).optional(),
1210
+ wipLimit: z.number().int().min(0).optional(),
1211
+ })
1212
+ .strict();
1213
+ /**
1214
+ * Удаление колонки: `moveItemsTo` — куда переносятся её пункты (`null` —
1215
+ * удалить вместе с колонкой); `version` — оптимистичная блокировка.
1216
+ */
1217
+ export const planColumnDeleteSchema = z
1218
+ .object({
1219
+ moveItemsTo: z.string().min(1).nullable(),
1220
+ version: z.number().int(),
1221
+ })
1222
+ .strict();
1223
+ /** Порядок колонок плана (полный список id) + версия. */
1224
+ export const planColumnsOrderSchema = z
1225
+ .object({
1226
+ order: z.array(z.string().min(1)),
1227
+ version: z.number().int(),
1228
+ })
1229
+ .strict();
1230
+ // --- Тела HTTP-мутаций ToDo (PROP-054) — strict ---
1231
+ /** Создание пункта ToDo. */
1232
+ export const todoCreateSchema = z
1233
+ .object({
1234
+ content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent),
1235
+ status: z.enum(TODO_STATUSES).optional(),
1236
+ priority: z.enum(TODO_PRIORITIES).optional(),
1237
+ planItemId: z.string().min(1).optional(),
1238
+ })
1239
+ .strict();
1240
+ /** Точечная правка пункта ToDo (`planItemId: null` — отвязать от пункта плана). */
1241
+ export const todoUpdateSchema = z
1242
+ .object({
1243
+ content: z.string().min(1).max(MARKDOWN_LIMITS.todoContent).optional(),
1244
+ status: z.enum(TODO_STATUSES).optional(),
1245
+ priority: z.enum(TODO_PRIORITIES).optional(),
1246
+ planItemId: z.string().min(1).nullable().optional(),
1247
+ })
1248
+ .strict();
1249
+ /** Новый порядок пунктов ToDo (только существующие id; новые — в конец). */
1250
+ export const todoOrderSchema = z
1251
+ .object({
1252
+ ids: z.array(z.string().min(1)),
1253
+ })
1254
+ .strict();
1255
+ /** Очистка пунктов ToDo по статусам (по умолчанию — `completed` + `cancelled`). */
1256
+ export const todoClearSchema = z
1257
+ .object({
1258
+ statuses: z.array(z.enum(TODO_STATUSES)).optional(),
1259
+ })
1260
+ .strict();
1261
+ // --- Тела HTTP-мутаций журнала и инвариантов (PROP-054) — strict ---
1262
+ /** Новая запись журнала проекта (Markdown, лимит `MARKDOWN_LIMITS.journalEntry`). */
1263
+ export const projectLogCreateSchema = z
1264
+ .object({
1265
+ text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
1266
+ })
1267
+ .strict();
1268
+ /** Правка текста записи журнала. */
1269
+ export const projectLogUpdateSchema = z
1270
+ .object({
1271
+ text: z.string().min(1).max(MARKDOWN_LIMITS.journalEntry),
1272
+ })
1273
+ .strict();
1274
+ /** Замена текста инвариантов проекта (Markdown, лимит `MARKDOWN_LIMITS.invariants`). */
1275
+ export const projectInvariantsUpdateSchema = z
1276
+ .object({
1277
+ invariants: z.string().max(MARKDOWN_LIMITS.invariants),
1278
+ })
1279
+ .strict();
@@ -1,5 +1,6 @@
1
1
  import type { ToolCapability } from './tools.js';
2
2
  import type { ReasoningLevel } from './session.js';
3
+ import type { EffortLevel } from './llm.js';
3
4
  export type AgentMode = 'primary' | 'subagent' | 'system';
4
5
  export interface AgentDefinition {
5
6
  id: string;
@@ -14,8 +15,14 @@ export interface AgentDefinition {
14
15
  topK?: number;
15
16
  /** Уровень размышлений агента. Не задано — используется session.settings.reasoningLevel. */
16
17
  reasoningLevel?: ReasoningLevel;
18
+ /**
19
+ * ADR-117: явный тир усилия (effort) агента — `low|medium|high|xhigh|max`.
20
+ * Приоритетнее `session.settings.effort` и уровня размышлений; единственный
21
+ * способ задать `xhigh`/`max` из настроек. Параметр уходит провайдеру только
22
+ * при `compatibility.supportsEffortUpdates` у модели.
23
+ */
24
+ effort?: EffortLevel;
17
25
  agentMode?: AgentMode | AgentMode[];
18
- subagentPrompt?: string;
19
26
  maxSteps?: number;
20
27
  isOverridden: boolean;
21
28
  icon?: string;
@@ -1,13 +1,27 @@
1
1
  import type { WorktreeUpdateAction } from './worktree.js';
2
- export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.moved' | 'project.updated' | 'worktree.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'message.injected' | 'steer.dropped' | 'stream.interrupted' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.chunk' | 'stream.usage' | 'stream.done' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'message.queued' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'pipeline.run.started' | 'pipeline.run.node_started' | 'pipeline.run.node_finished' | 'pipeline.run.awaiting_human' | 'pipeline.run.finished' | 'pipeline.run.failed' | 'pipeline.completed' | 'user_question.asked' | 'user_question.answered' | 'user_question.cancelled' | 'process.started' | 'process.exited' | 'process.stopped' | 'process.detached' | 'child.started' | 'child.completed' | 'child.failed' | 'child.cancelled' | 'error';
2
+ import type { MessageAcceptedPayload, QueueStatePayload, MessageDeliveredPayload, MessageEnqueuedPayload, TurnStartedPayload, TurnFinishedPayload, StepStartedPayload, StepFinishedPayload, StepToolsPayload, PartDeltaPayload, PartUpdatedPayload } from './message-stream.js';
3
+ export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.messages.cleared' | 'session.moved' | 'project.updated' | 'project.deleted' | 'worktree.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'message.accepted' | 'queue.state' | 'message.delivered' | 'message.enqueued' | 'message.deleted' | 'turn.started' | 'turn.finished' | 'step.started' | 'step.finished' | 'step.tools.started' | 'step.tools.finished' | 'part.delta' | 'part.updated' | 'steer.dropped' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarization_applied' | 'context.summarization_failed' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'plan.updated' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'pipeline.run.started' | 'pipeline.run.node_started' | 'pipeline.run.node_finished' | 'pipeline.run.awaiting_human' | 'pipeline.run.finished' | 'pipeline.run.failed' | 'pipeline.completed' | 'user_question.asked' | 'user_question.answered' | 'user_question.cancelled' | 'process.started' | 'process.exited' | 'process.stopped' | 'process.detached' | 'child.started' | 'child.completed' | 'child.failed' | 'child.cancelled' | 'error';
3
4
  export interface BusEvent {
4
5
  type: EventType;
5
6
  sessionId: string;
6
7
  data: Record<string, unknown>;
7
8
  timestamp: string;
9
+ /**
10
+ * ADR-118 §4/§«Гибрид и многопользовательский режим»: идентификатор
11
+ * пользователя-получателя (адресная доставка). Поле отсутствует → broadcast
12
+ * в канал сессии; `message.accepted` — адресное событие.
13
+ */
14
+ recipient?: string;
15
+ /**
16
+ * ADR-118 §«Событийная нумерация»: монотонный номер события **в пределах
17
+ * инстанса** (сквозной по всем сессионным каналам) — по нему работает догон
18
+ * (`Last-Event-ID` / `?since`). Инстансный канал (`pipeline.run.*`) номера
19
+ * не получает.
20
+ */
21
+ eventSeq?: number;
8
22
  }
9
23
  /**
10
- * Payload события `worktree.updated` (ADR-114 §6) — инвентарь worktree'ов
24
+ * Payload события `worktree.updated` (ADR-114 §6) — инвентарь worktree
11
25
  * проекта изменился.
12
26
  *
13
27
  * Событие идёт в **каналы сессий проекта** (инвентарь — ресурс проекта, а не
@@ -27,3 +41,47 @@ export type WorktreeUpdatedPayload = {
27
41
  /** Что произошло (ADR-114 §6). */
28
42
  action: WorktreeUpdateAction;
29
43
  };
44
+ /** Payload события `message.accepted` (ADR-118 §4) — адресное событие. */
45
+ export type MessageAcceptedEventData = MessageAcceptedPayload;
46
+ /** Payload события `queue.state` (ADR-118 §4) — только счётчики. */
47
+ export type QueueStateEventData = QueueStatePayload;
48
+ /** Payload события `message.delivered` (ADR-118 §4) — материализация в истории. */
49
+ export type MessageDeliveredEventData = MessageDeliveredPayload;
50
+ /** Payload события `message.enqueued` (ADR-118 §4) — адресное, со снимком сообщения. */
51
+ export type MessageEnqueuedEventData = MessageEnqueuedPayload;
52
+ /** Payload события `turn.started` (ADR-118 §4) — ход начался. */
53
+ export type TurnStartedEventData = TurnStartedPayload;
54
+ /** Payload события `turn.finished` (ADR-118 §4) — ход завершён. */
55
+ export type TurnFinishedEventData = TurnFinishedPayload;
56
+ /** Payload события `step.started` (ADR-118 §4) — шаг начался. */
57
+ export type StepStartedEventData = StepStartedPayload;
58
+ /** Payload события `step.finished` (ADR-118 §4/§5) — шаг завершён. */
59
+ export type StepFinishedEventData = StepFinishedPayload;
60
+ /** Payload событий `step.tools.started`/`step.tools.finished` (ADR-118 §4). */
61
+ export type StepToolsEventData = StepToolsPayload;
62
+ /** Payload события `part.delta` (ADR-118 §4) — дельта части (upsert). */
63
+ export type PartDeltaEventData = PartDeltaPayload;
64
+ /** Payload события `part.updated` (ADR-118 §4) — часть обновлена (upsert). */
65
+ export type PartUpdatedEventData = PartUpdatedPayload;
66
+ /** Payload события `message.deleted` (ADR-118 §4/§7) — удалённое сообщение. */
67
+ export type MessageDeletedEventData = {
68
+ /** id удалённого сообщения (мутации адресуются по id, ADR-118 §7). */
69
+ message_id: string;
70
+ };
71
+ /** Payload события `message.updated` (ADR-118 §4) — состояние сообщения изменилось. */
72
+ export type MessageUpdatedEventData = {
73
+ /** id изменённого сообщения. */
74
+ message_id: string;
75
+ /** Новое значение `pinned` (событие приходит от pin/batch pin). */
76
+ pinned?: boolean;
77
+ /** Новое значение `disabled` (toggle/batch toggle/retry). */
78
+ disabled?: boolean;
79
+ };
80
+ /** Payload события `session.messages.cleared` — история очищена, кроме закреплённых. */
81
+ export type SessionMessagesClearedEventData = {
82
+ session_id: string;
83
+ };
84
+ /** Payload событий `project.updated`/`project.deleted` — проект сессии изменился. */
85
+ export type ProjectChangedEventData = {
86
+ project_id: string;
87
+ };
@@ -93,9 +93,9 @@ export interface EgressRequestLogEntry {
93
93
  actor?: string;
94
94
  }
95
95
  /** Скоупы изменений egress-политик/прокси в security-аудите. */
96
- export declare const SECURITY_AUDIT_SCOPES: readonly ["tools", "webhooks", "mcp", "proxy", "tls", "attachments"];
96
+ export declare const SECURITY_AUDIT_SCOPES: readonly ["tools", "webhooks", "mcp", "proxy", "tls", "attachments", "context-window", "context-defaults", "sticky-notes", "agents", "limits", "permission", "ssh"];
97
97
  export type SecurityAuditScope = (typeof SECURITY_AUDIT_SCOPES)[number];
98
- export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset"];
98
+ export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset", "grant", "revoke"];
99
99
  export type SecurityAuditAction = (typeof SECURITY_AUDIT_ACTIONS)[number];
100
100
  /**
101
101
  * Запись аудита изменений security-политик (append-only). `before`/`after` —
@@ -64,5 +64,5 @@ export const EGRESS_REQUEST_STATUSES = ['allowed', 'blocked', 'error'];
64
64
  */
65
65
  export const EGRESS_REQUEST_VIAS = ['proxy', 'direct', 'fallback'];
66
66
  /** Скоупы изменений egress-политик/прокси в security-аудите. */
67
- export const SECURITY_AUDIT_SCOPES = ['tools', 'webhooks', 'mcp', 'proxy', 'tls', 'attachments'];
68
- export const SECURITY_AUDIT_ACTIONS = ['update', 'reset'];
67
+ export const SECURITY_AUDIT_SCOPES = ['tools', 'webhooks', 'mcp', 'proxy', 'tls', 'attachments', 'context-window', 'context-defaults', 'sticky-notes', 'agents', 'limits', 'permission', 'ssh'];
68
+ export const SECURITY_AUDIT_ACTIONS = ['update', 'reset', 'grant', 'revoke'];
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Классификация файла проекта по расширению — **browser-safe** контракт
3
+ * (только чистые функции и константы, без `node:*` и без zod-схем): его
4
+ * импортирует UI (`@itphx/synth-shared/types`), чтобы клиент и сервер
5
+ * одинаково понимали, что за файл и можно ли его отдавать inline.
6
+ *
7
+ * Единый источник истины — здесь: `isTextFile()` в core (`server/fs-workspace.ts`)
8
+ * отвечает на другой вопрос («это текст или бинарь — по содержимому») и не
9
+ * дублируется здесь. Этот модуль отвечает на вопрос «какого семейства файл
10
+ * по расширению» (для выбора превью и MIME).
11
+ */
12
+ /** Семейство файла (по расширению). */
13
+ export type FileKind = 'text' | 'markdown' | 'code' | 'image' | 'video' | 'audio' | 'pdf' | 'binary';
14
+ /**
15
+ * Семейство файла по расширению (регистронезависимо).
16
+ *
17
+ * Неизвестное расширение (и файл без расширения) → `binary` — консервативно:
18
+ * такой файл нельзя отдавать inline (см. `INLINE_PREVIEW_KINDS`).
19
+ */
20
+ export declare function fileKind(path: string): FileKind;
21
+ /**
22
+ * MIME-тип файла по расширению (регистронезависимо).
23
+ *
24
+ * `binary`/неизвестное расширение → `application/octet-stream`; текст, код и
25
+ * markdown → `text/plain` (или точный MIME из таблицы выше).
26
+ *
27
+ * ⚠️ MIME **не** определяет, можно ли отдавать файл inline: этим занимается
28
+ * allow-list `INLINE_PREVIEW_KINDS` (см. `GET /api/v2/fs/raw`).
29
+ */
30
+ export declare function fileMime(path: string): string;
31
+ /**
32
+ * Семейства файлов, которые разрешено отдавать **inline** (в `<img>`,
33
+ * `<video>`, `<audio>`, `<embed>`), а не как вложение.
34
+ *
35
+ * HTML/CSS/JS и прочий текст/код **в списке нет** — иначе `text/html`
36
+ * исполнился бы в origin приложения (XSS). Правило — на сервере:
37
+ * `GET /api/v2/fs/raw` для kind вне списка отдаёт `application/octet-stream`
38
+ * + `Content-Disposition: attachment`.
39
+ */
40
+ export declare const INLINE_PREVIEW_KINDS: readonly FileKind[];