@itphx/synth-shared 0.12.4 → 0.13.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 (41) hide show
  1. package/dist/config/defaults.js +97 -4
  2. package/dist/config/env-overrides.js +29 -0
  3. package/dist/config/resolve.d.ts +17 -0
  4. package/dist/config/resolve.js +40 -1
  5. package/dist/config/types.d.ts +394 -7
  6. package/dist/config/types.js +275 -6
  7. package/dist/i18n/index.d.ts +1 -1
  8. package/dist/i18n/index.js +188 -3
  9. package/dist/index.d.ts +2 -2
  10. package/dist/index.js +2 -2
  11. package/dist/schemas/index.d.ts +90 -10
  12. package/dist/schemas/index.js +55 -4
  13. package/dist/types/agent.d.ts +8 -1
  14. package/dist/types/bus-events.d.ts +59 -1
  15. package/dist/types/egress.d.ts +1 -1
  16. package/dist/types/egress.js +1 -1
  17. package/dist/types/file-kind.d.ts +40 -0
  18. package/dist/types/file-kind.js +157 -0
  19. package/dist/types/fs.d.ts +54 -1
  20. package/dist/types/fs.js +43 -0
  21. package/dist/types/git.d.ts +5 -0
  22. package/dist/types/index.d.ts +2 -0
  23. package/dist/types/index.js +6 -0
  24. package/dist/types/llm.d.ts +95 -0
  25. package/dist/types/llm.js +58 -0
  26. package/dist/types/message-stream.d.ts +348 -0
  27. package/dist/types/message-stream.js +41 -0
  28. package/dist/types/message.d.ts +49 -0
  29. package/dist/types/pack.d.ts +6 -6
  30. package/dist/types/permission.d.ts +26 -0
  31. package/dist/types/pipeline-engine.d.ts +2 -2
  32. package/dist/types/provider.d.ts +280 -0
  33. package/dist/types/provider.js +289 -0
  34. package/dist/types/session.d.ts +170 -3
  35. package/dist/types/tools.d.ts +21 -0
  36. package/dist/types/tools.js +1 -1
  37. package/dist/utils/reasoning.d.ts +18 -2
  38. package/dist/utils/reasoning.js +16 -7
  39. package/dist/version.d.ts +1 -1
  40. package/dist/version.js +1 -1
  41. package/package.json +2 -2
@@ -110,17 +110,71 @@ export declare const tokenUsageSchema: z.ZodObject<{
110
110
  export declare function patchObjectSchema<S extends z.ZodRawShape>(schema: z.ZodObject<S>): z.ZodObject<{
111
111
  [K in keyof S]: z.ZodOptional<S[K]>;
112
112
  }>;
113
+ /**
114
+ * Instance-wide дефолты оптимизации контекста для новых сессий
115
+ * (`context.defaults`, runtime-override — `/api/v2/settings/context-defaults`).
116
+ *
117
+ * Значения по умолчанию совпадают с прежними литералами
118
+ * `SessionManager.createSession`: новая сессия без явных `settings` получает
119
+ * ровно те же настройки, что и до появления настройки инстанса.
120
+ */
121
+ export declare const contextDefaultsSchema: z.ZodObject<{
122
+ contextOptimization: z.ZodDefault<z.ZodEnum<{
123
+ compaction: "compaction";
124
+ none: "none";
125
+ sliding_window: "sliding_window";
126
+ summarization: "summarization";
127
+ }>>;
128
+ summarizationEnabled: z.ZodDefault<z.ZodBoolean>;
129
+ summarizationTriggerMode: z.ZodDefault<z.ZodEnum<{
130
+ messages: "messages";
131
+ tokens: "tokens";
132
+ }>>;
133
+ summarizeAfterN: z.ZodDefault<z.ZodNumber>;
134
+ summarizeTokenThreshold: z.ZodDefault<z.ZodNumber>;
135
+ summarizationHeadMessages: z.ZodDefault<z.ZodNumber>;
136
+ summarizationTailMessages: z.ZodDefault<z.ZodNumber>;
137
+ summarizationKeepTokens: z.ZodDefault<z.ZodNumber>;
138
+ compactionKeepTokens: z.ZodDefault<z.ZodNumber>;
139
+ compactionTokenThreshold: z.ZodDefault<z.ZodNumber>;
140
+ slidingWindowMode: z.ZodDefault<z.ZodEnum<{
141
+ messages: "messages";
142
+ tokens: "tokens";
143
+ }>>;
144
+ slidingWindowMessageLimit: z.ZodDefault<z.ZodNumber>;
145
+ slidingWindowTokenThreshold: z.ZodDefault<z.ZodNumber>;
146
+ }, z.core.$strip>;
147
+ /**
148
+ * Instance-wide лимиты заметок сессии (`context.stickyNotes`).
149
+ *
150
+ * Не дефолты сессии, а **ограничения инстанса**: применяются ко всем сессиям
151
+ * при создании/изменении заметки. Runtime-override —
152
+ * `/api/v2/settings/sticky-notes`. Значения по умолчанию совпадают с прежним
153
+ * поведением (заметки не ограничивались) и задают разумный верхний предел,
154
+ * чтобы заметки не превращались в бездонный канал контекста.
155
+ */
156
+ export declare const stickyNotesLimitsSchema: z.ZodObject<{
157
+ maxCount: z.ZodDefault<z.ZodNumber>;
158
+ maxChars: z.ZodDefault<z.ZodNumber>;
159
+ }, z.core.$strip>;
113
160
  export declare const sessionSettingsSchema: z.ZodObject<{
114
161
  provider: z.ZodOptional<z.ZodString>;
115
162
  model: z.ZodOptional<z.ZodString>;
116
163
  reasoningLevel: z.ZodOptional<z.ZodEnum<{
117
164
  default: "default";
165
+ none: "none";
118
166
  high: "high";
119
167
  medium: "medium";
120
168
  low: "low";
121
- none: "none";
122
169
  }>>;
123
- temperature: z.ZodDefault<z.ZodNumber>;
170
+ effort: z.ZodOptional<z.ZodEnum<{
171
+ high: "high";
172
+ medium: "medium";
173
+ low: "low";
174
+ xhigh: "xhigh";
175
+ max: "max";
176
+ }>>;
177
+ temperature: z.ZodOptional<z.ZodNumber>;
124
178
  maxTokens: z.ZodDefault<z.ZodNumber>;
125
179
  systemPrompt: z.ZodOptional<z.ZodString>;
126
180
  debugEnabled: z.ZodDefault<z.ZodBoolean>;
@@ -129,6 +183,7 @@ export declare const sessionSettingsSchema: z.ZodObject<{
129
183
  mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
130
184
  mcpDisabledServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
131
185
  contextOptimization: z.ZodDefault<z.ZodEnum<{
186
+ compaction: "compaction";
132
187
  none: "none";
133
188
  sliding_window: "sliding_window";
134
189
  summarization: "summarization";
@@ -149,6 +204,9 @@ export declare const sessionSettingsSchema: z.ZodObject<{
149
204
  summarizeTokenThreshold: z.ZodDefault<z.ZodNumber>;
150
205
  summarizationHeadMessages: z.ZodDefault<z.ZodNumber>;
151
206
  summarizationTailMessages: z.ZodDefault<z.ZodNumber>;
207
+ summarizationKeepTokens: z.ZodDefault<z.ZodNumber>;
208
+ compactionKeepTokens: z.ZodDefault<z.ZodNumber>;
209
+ compactionTokenThreshold: z.ZodDefault<z.ZodNumber>;
152
210
  showInterview: z.ZodDefault<z.ZodBoolean>;
153
211
  websocketEnabled: z.ZodDefault<z.ZodBoolean>;
154
212
  language: z.ZodOptional<z.ZodString>;
@@ -227,12 +285,19 @@ export declare const sessionCreateSchema: z.ZodObject<{
227
285
  model: z.ZodOptional<z.ZodString>;
228
286
  reasoningLevel: z.ZodOptional<z.ZodEnum<{
229
287
  default: "default";
288
+ none: "none";
230
289
  high: "high";
231
290
  medium: "medium";
232
291
  low: "low";
233
- none: "none";
234
292
  }>>;
235
- temperature: z.ZodDefault<z.ZodNumber>;
293
+ effort: z.ZodOptional<z.ZodEnum<{
294
+ high: "high";
295
+ medium: "medium";
296
+ low: "low";
297
+ xhigh: "xhigh";
298
+ max: "max";
299
+ }>>;
300
+ temperature: z.ZodOptional<z.ZodNumber>;
236
301
  maxTokens: z.ZodDefault<z.ZodNumber>;
237
302
  systemPrompt: z.ZodOptional<z.ZodString>;
238
303
  debugEnabled: z.ZodDefault<z.ZodBoolean>;
@@ -241,6 +306,7 @@ export declare const sessionCreateSchema: z.ZodObject<{
241
306
  mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
242
307
  mcpDisabledServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
243
308
  contextOptimization: z.ZodDefault<z.ZodEnum<{
309
+ compaction: "compaction";
244
310
  none: "none";
245
311
  sliding_window: "sliding_window";
246
312
  summarization: "summarization";
@@ -261,6 +327,9 @@ export declare const sessionCreateSchema: z.ZodObject<{
261
327
  summarizeTokenThreshold: z.ZodDefault<z.ZodNumber>;
262
328
  summarizationHeadMessages: z.ZodDefault<z.ZodNumber>;
263
329
  summarizationTailMessages: z.ZodDefault<z.ZodNumber>;
330
+ summarizationKeepTokens: z.ZodDefault<z.ZodNumber>;
331
+ compactionKeepTokens: z.ZodDefault<z.ZodNumber>;
332
+ compactionTokenThreshold: z.ZodDefault<z.ZodNumber>;
264
333
  showInterview: z.ZodDefault<z.ZodBoolean>;
265
334
  websocketEnabled: z.ZodDefault<z.ZodBoolean>;
266
335
  language: z.ZodOptional<z.ZodString>;
@@ -339,12 +408,19 @@ export declare const sessionUpdateSchema: z.ZodObject<{
339
408
  model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
340
409
  reasoningLevel: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
341
410
  default: "default";
411
+ none: "none";
342
412
  high: "high";
343
413
  medium: "medium";
344
414
  low: "low";
345
- none: "none";
346
415
  }>>>;
347
- temperature: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
416
+ effort: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
417
+ high: "high";
418
+ medium: "medium";
419
+ low: "low";
420
+ xhigh: "xhigh";
421
+ max: "max";
422
+ }>>>;
423
+ temperature: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
348
424
  maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
349
425
  systemPrompt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
350
426
  debugEnabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
@@ -353,6 +429,7 @@ export declare const sessionUpdateSchema: z.ZodObject<{
353
429
  mcpServers: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
354
430
  mcpDisabledServers: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
355
431
  contextOptimization: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
432
+ compaction: "compaction";
356
433
  none: "none";
357
434
  sliding_window: "sliding_window";
358
435
  summarization: "summarization";
@@ -373,6 +450,9 @@ export declare const sessionUpdateSchema: z.ZodObject<{
373
450
  summarizeTokenThreshold: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
374
451
  summarizationHeadMessages: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
375
452
  summarizationTailMessages: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
453
+ summarizationKeepTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
454
+ compactionKeepTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
455
+ compactionTokenThreshold: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
376
456
  showInterview: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
377
457
  websocketEnabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
378
458
  language: z.ZodOptional<z.ZodOptional<z.ZodString>>;
@@ -951,8 +1031,8 @@ export declare const eventBindingSchema: z.ZodObject<{
951
1031
  /** ADR-089: схема запроса создания/привязки сессии — единый funnel. */
952
1032
  export declare const sessionRequestSchema: z.ZodObject<{
953
1033
  initiator: z.ZodEnum<{
954
- user: "user";
955
1034
  system: "system";
1035
+ user: "user";
956
1036
  agent: "agent";
957
1037
  external: "external";
958
1038
  }>;
@@ -1578,8 +1658,8 @@ export type ScheduleInputRequest = z.infer<typeof scheduleInputSchema>;
1578
1658
  export type ScheduleRequest = z.infer<typeof scheduleSchema>;
1579
1659
  /** ADR-051: триггер срабатывания расписания в Job-истории. */
1580
1660
  export declare const scheduleJobTriggerSchema: z.ZodEnum<{
1581
- cron: "cron";
1582
1661
  manual: "manual";
1662
+ cron: "cron";
1583
1663
  catchup: "catchup";
1584
1664
  }>;
1585
1665
  /** ADR-051: запись Job-истории (ответы `GET /api/v2/schedules/:id/jobs`). */
@@ -1588,8 +1668,8 @@ export declare const scheduleJobSchema: z.ZodObject<{
1588
1668
  scheduleId: z.ZodString;
1589
1669
  scheduleName: z.ZodString;
1590
1670
  trigger: z.ZodEnum<{
1591
- cron: "cron";
1592
1671
  manual: "manual";
1672
+ cron: "cron";
1593
1673
  catchup: "catchup";
1594
1674
  }>;
1595
1675
  status: z.ZodEnum<{
@@ -1620,8 +1700,8 @@ export declare const scheduleJobSchema: z.ZodObject<{
1620
1700
  }, z.core.$strip>], "mode">;
1621
1701
  dedupKey: z.ZodOptional<z.ZodString>;
1622
1702
  decision: z.ZodOptional<z.ZodEnum<{
1623
- pipeline: "pipeline";
1624
1703
  queue: "queue";
1704
+ pipeline: "pipeline";
1625
1705
  bound: "bound";
1626
1706
  ephemeral: "ephemeral";
1627
1707
  bind: "bind";
@@ -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, } 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(),
@@ -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,10 +1,24 @@
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.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
24
  * Payload события `worktree.updated` (ADR-114 §6) — инвентарь worktree'ов
@@ -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,7 +93,7 @@ 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"];
97
97
  export type SecurityAuditScope = (typeof SECURITY_AUDIT_SCOPES)[number];
98
98
  export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset"];
99
99
  export type SecurityAuditAction = (typeof SECURITY_AUDIT_ACTIONS)[number];
@@ -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'];
67
+ export const SECURITY_AUDIT_SCOPES = ['tools', 'webhooks', 'mcp', 'proxy', 'tls', 'attachments', 'context-window', 'context-defaults', 'sticky-notes', 'agents'];
68
68
  export const SECURITY_AUDIT_ACTIONS = ['update', 'reset'];
@@ -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[];
@@ -0,0 +1,157 @@
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
+ const MARKDOWN_EXTENSIONS = new Set(['.md', '.markdown', '.mdown']);
13
+ const IMAGE_EXTENSIONS = new Set([
14
+ '.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.ico', '.svg',
15
+ '.avif', '.tif', '.tiff',
16
+ ]);
17
+ const VIDEO_EXTENSIONS = new Set([
18
+ '.mp4', '.m4v', '.webm', '.mov', '.ogv', '.avi', '.mkv',
19
+ ]);
20
+ const AUDIO_EXTENSIONS = new Set([
21
+ '.mp3', '.wav', '.ogg', '.oga', '.flac', '.m4a', '.aac', '.opus',
22
+ ]);
23
+ const CODE_EXTENSIONS = new Set([
24
+ '.js', '.jsx', '.mjs', '.cjs', '.ts', '.tsx', '.mts', '.cts',
25
+ '.py', '.rb', '.rs', '.go', '.java', '.kt', '.kts', '.swift',
26
+ '.c', '.h', '.cc', '.cpp', '.hpp', '.cs', '.php', '.lua', '.pl', '.pm',
27
+ '.sh', '.bash', '.zsh', '.fish', '.ps1', '.bat', '.cmd',
28
+ '.vue', '.svelte', '.astro',
29
+ '.html', '.htm', '.css', '.scss', '.sass', '.less',
30
+ '.sql', '.graphql', '.gql', '.proto', '.prisma',
31
+ '.tf', '.tfvars', '.gradle', '.m', '.mm',
32
+ '.ex', '.exs', '.erl', '.hs', '.clj', '.groovy', '.dart', '.r', '.jl', '.nim', '.zig',
33
+ // Конфиги
34
+ '.yaml', '.yml', '.json', '.jsonl', '.toml', '.xml',
35
+ ]);
36
+ const TEXT_EXTENSIONS = new Set([
37
+ '.txt', '.csv', '.log', '.env', '.ini', '.cfg', '.conf',
38
+ '.rst', '.adoc', '.org',
39
+ '.tex', '.bib', '.patch', '.diff', '.srt', '.vtt',
40
+ ]);
41
+ /** Расширение пути в нижнем регистре (с точкой); без расширения — `''`. */
42
+ function extensionOf(path) {
43
+ const name = path.split(/[\\/]/).pop() ?? path;
44
+ const dot = name.lastIndexOf('.');
45
+ // Точка в начале имени (`.gitignore`) — расширения нет.
46
+ if (dot <= 0)
47
+ return '';
48
+ return name.slice(dot).toLowerCase();
49
+ }
50
+ /**
51
+ * Семейство файла по расширению (регистронезависимо).
52
+ *
53
+ * Неизвестное расширение (и файл без расширения) → `binary` — консервативно:
54
+ * такой файл нельзя отдавать inline (см. `INLINE_PREVIEW_KINDS`).
55
+ */
56
+ export function fileKind(path) {
57
+ const ext = extensionOf(path);
58
+ if (!ext)
59
+ return 'binary';
60
+ if (MARKDOWN_EXTENSIONS.has(ext))
61
+ return 'markdown';
62
+ if (IMAGE_EXTENSIONS.has(ext))
63
+ return 'image';
64
+ if (VIDEO_EXTENSIONS.has(ext))
65
+ return 'video';
66
+ if (AUDIO_EXTENSIONS.has(ext))
67
+ return 'audio';
68
+ if (ext === '.pdf')
69
+ return 'pdf';
70
+ if (CODE_EXTENSIONS.has(ext))
71
+ return 'code';
72
+ if (TEXT_EXTENSIONS.has(ext))
73
+ return 'text';
74
+ return 'binary';
75
+ }
76
+ /** MIME по расширению; `binary`/неизвестное → `application/octet-stream`. */
77
+ const MIME_BY_EXTENSION = {
78
+ // Изображения
79
+ '.png': 'image/png',
80
+ '.jpg': 'image/jpeg',
81
+ '.jpeg': 'image/jpeg',
82
+ '.gif': 'image/gif',
83
+ '.webp': 'image/webp',
84
+ '.bmp': 'image/bmp',
85
+ '.ico': 'image/x-icon',
86
+ '.svg': 'image/svg+xml',
87
+ '.avif': 'image/avif',
88
+ '.tif': 'image/tiff',
89
+ '.tiff': 'image/tiff',
90
+ // Видео
91
+ '.mp4': 'video/mp4',
92
+ '.m4v': 'video/mp4',
93
+ '.webm': 'video/webm',
94
+ '.mov': 'video/quicktime',
95
+ '.ogv': 'video/ogg',
96
+ '.avi': 'video/x-msvideo',
97
+ '.mkv': 'video/x-matroska',
98
+ // Аудио
99
+ '.mp3': 'audio/mpeg',
100
+ '.wav': 'audio/wav',
101
+ '.ogg': 'audio/ogg',
102
+ '.oga': 'audio/ogg',
103
+ '.flac': 'audio/flac',
104
+ '.m4a': 'audio/mp4',
105
+ '.aac': 'audio/aac',
106
+ '.opus': 'audio/opus',
107
+ // Документы
108
+ '.pdf': 'application/pdf',
109
+ // Текст/код
110
+ '.md': 'text/markdown',
111
+ '.markdown': 'text/markdown',
112
+ '.mdown': 'text/markdown',
113
+ '.json': 'application/json',
114
+ '.jsonl': 'application/json',
115
+ '.xml': 'application/xml',
116
+ '.yaml': 'application/yaml',
117
+ '.yml': 'application/yaml',
118
+ '.toml': 'application/toml',
119
+ '.csv': 'text/csv',
120
+ '.html': 'text/html',
121
+ '.htm': 'text/html',
122
+ '.css': 'text/css',
123
+ '.js': 'text/javascript',
124
+ '.mjs': 'text/javascript',
125
+ '.cjs': 'text/javascript',
126
+ };
127
+ /**
128
+ * MIME-тип файла по расширению (регистронезависимо).
129
+ *
130
+ * `binary`/неизвестное расширение → `application/octet-stream`; текст, код и
131
+ * markdown → `text/plain` (или точный MIME из таблицы выше).
132
+ *
133
+ * ⚠️ MIME **не** определяет, можно ли отдавать файл inline: этим занимается
134
+ * allow-list `INLINE_PREVIEW_KINDS` (см. `GET /api/v2/fs/raw`).
135
+ */
136
+ export function fileMime(path) {
137
+ const ext = extensionOf(path);
138
+ if (!ext)
139
+ return 'application/octet-stream';
140
+ const known = MIME_BY_EXTENSION[ext];
141
+ if (known)
142
+ return known;
143
+ const kind = fileKind(path);
144
+ if (kind === 'markdown' || kind === 'code' || kind === 'text')
145
+ return 'text/plain';
146
+ return 'application/octet-stream';
147
+ }
148
+ /**
149
+ * Семейства файлов, которые разрешено отдавать **inline** (в `<img>`,
150
+ * `<video>`, `<audio>`, `<embed>`), а не как вложение.
151
+ *
152
+ * HTML/CSS/JS и прочий текст/код **в списке нет** — иначе `text/html`
153
+ * исполнился бы в origin приложения (XSS). Правило — на сервере:
154
+ * `GET /api/v2/fs/raw` для kind вне списка отдаёт `application/octet-stream`
155
+ * + `Content-Disposition: attachment`.
156
+ */
157
+ export const INLINE_PREVIEW_KINDS = ['image', 'video', 'audio', 'pdf'];