@itphx/synth-shared 0.13.8 → 0.13.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/dist/config/defaults.js +74 -2
  2. package/dist/config/env-overrides.d.ts +16 -0
  3. package/dist/config/env-overrides.js +103 -3
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +2 -0
  9. package/dist/config/index.js +2 -0
  10. package/dist/config/security.d.ts +77 -0
  11. package/dist/config/security.js +116 -0
  12. package/dist/config/types.d.ts +466 -34
  13. package/dist/config/types.js +317 -33
  14. package/dist/i18n/index.d.ts +1 -1
  15. package/dist/i18n/index.js +196 -13
  16. package/dist/index.d.ts +5 -4
  17. package/dist/index.js +15 -2
  18. package/dist/schemas/index.d.ts +156 -19
  19. package/dist/schemas/index.js +126 -15
  20. package/dist/skills/frontmatter.js +1 -1
  21. package/dist/types/agent.d.ts +29 -1
  22. package/dist/types/authority.d.ts +10 -0
  23. package/dist/types/authority.js +8 -0
  24. package/dist/types/bus-events.d.ts +87 -1
  25. package/dist/types/catalog.d.ts +1 -1
  26. package/dist/types/catalog.js +1 -1
  27. package/dist/types/command-audit.d.ts +91 -0
  28. package/dist/types/command-audit.js +44 -0
  29. package/dist/types/commands.d.ts +29 -11
  30. package/dist/types/commands.js +2 -2
  31. package/dist/types/egress.d.ts +18 -3
  32. package/dist/types/egress.js +18 -3
  33. package/dist/types/events.d.ts +23 -2
  34. package/dist/types/execution.d.ts +424 -0
  35. package/dist/types/execution.js +355 -0
  36. package/dist/types/file-kind.d.ts +3 -2
  37. package/dist/types/file-kind.js +11 -2
  38. package/dist/types/git.d.ts +48 -0
  39. package/dist/types/index.d.ts +6 -0
  40. package/dist/types/index.js +18 -2
  41. package/dist/types/mentions.d.ts +96 -0
  42. package/dist/types/mentions.js +9 -0
  43. package/dist/types/message.d.ts +24 -1
  44. package/dist/types/message.js +13 -0
  45. package/dist/types/pack.d.ts +21 -21
  46. package/dist/types/pack.js +4 -4
  47. package/dist/types/permission.d.ts +8 -1
  48. package/dist/types/pipeline.d.ts +2 -2
  49. package/dist/types/plugin-protocol.d.ts +203 -4
  50. package/dist/types/plugin-protocol.js +77 -4
  51. package/dist/types/project-access.d.ts +94 -0
  52. package/dist/types/project-access.js +140 -0
  53. package/dist/types/project.d.ts +59 -2
  54. package/dist/types/project.js +20 -0
  55. package/dist/types/schedules.d.ts +49 -3
  56. package/dist/types/schedules.js +50 -1
  57. package/dist/types/scripts.d.ts +98 -0
  58. package/dist/types/scripts.js +14 -0
  59. package/dist/types/service-keys.d.ts +12 -2
  60. package/dist/types/service-keys.js +13 -0
  61. package/dist/types/session.d.ts +60 -3
  62. package/dist/types/skills.d.ts +15 -11
  63. package/dist/types/skills.js +6 -6
  64. package/dist/types/timers.d.ts +402 -0
  65. package/dist/types/timers.js +166 -0
  66. package/dist/types/tools.d.ts +124 -1
  67. package/dist/types/tools.js +22 -0
  68. package/dist/types/user.d.ts +17 -0
  69. package/dist/version.d.ts +1 -1
  70. package/dist/version.js +1 -1
  71. package/package.json +2 -2
@@ -0,0 +1,402 @@
1
+ /**
2
+ * PROP-141 (Часть B): контракты таймеров и будильников.
3
+ *
4
+ * Таймер и будильник — **один тип** с двумя видами (`kind`): таймер
5
+ * относительный («через 15 минут»), будильник — абсолютный/повторяющийся
6
+ * («завтра в 09:00», «каждые 10 минут»). Отличие от расписания (ADR-051):
7
+ * у расписания есть **свой текст задания**, здесь несёт только комментарий —
8
+ * смысл срабатывания восстанавливает сам агент по комментарию и истории.
9
+ *
10
+ * Здесь только контракты (типы + Zod-схемы) — без бизнес-логики: вычисление
11
+ * `firesAt`, догон (catch-up), дедуп и доставка живут в core (`engine/timers/`,
12
+ * следующий этап PROP-141). Персистентность — доменные порты
13
+ * `TimerRepository`/`TimerFiringRepository` (ADR-096).
14
+ */
15
+ import { z } from 'zod';
16
+ /**
17
+ * Вид автоматизации:
18
+ * - `timer` — относительный отсчёт («через N секунд»);
19
+ * - `alarm` — абсолютное время (`at`) либо повтор (`daily`/`every`).
20
+ */
21
+ export type TimerKind = 'timer' | 'alarm';
22
+ /** Канонический набор видов автоматизации. */
23
+ export declare const TIMER_KINDS: readonly TimerKind[];
24
+ /**
25
+ * Режим повтора срабатывания:
26
+ * - `once` — одноразовое срабатывание;
27
+ * - `daily` — ежедневно в `time` (`HH:MM`) в часовом поясе `timezone`;
28
+ * - `every` — каждые `everySec` секунд.
29
+ *
30
+ * `weekly`/cron нет (решение владельца, PROP-141).
31
+ */
32
+ export type TimerRepeat = {
33
+ mode: 'once';
34
+ } | {
35
+ mode: 'daily';
36
+ time: string;
37
+ timezone: string;
38
+ } | {
39
+ mode: 'every';
40
+ everySec: number;
41
+ };
42
+ /** Канонический набор режимов повтора. */
43
+ export declare const TIMER_REPEAT_MODES: readonly TimerRepeat['mode'][];
44
+ /**
45
+ * Статус таймера:
46
+ * - `active` — ждёт срабатывания;
47
+ * - `paused` — приостановлен (срабатывание не наступит);
48
+ * - `fired` — сработал (one-shot);
49
+ * - `cancelled` — отменён (в т.ч. каскадом при удалении сессии).
50
+ */
51
+ export type TimerStatus = 'active' | 'paused' | 'fired' | 'cancelled';
52
+ /** Канонический набор статусов таймера. */
53
+ export declare const TIMER_STATUSES: readonly TimerStatus[];
54
+ /**
55
+ * Минимальный интервал/повтор — 10 секунд (решение владельца, PROP-141).
56
+ * Интервал меньше — заведомо «мгновенное» повторение, а не автоматизация.
57
+ */
58
+ export declare const TIMER_MIN_INTERVAL_SEC = 10;
59
+ /** Потолок длины комментария (единственный «смысл» срабатывания). */
60
+ export declare const TIMER_COMMENT_MAX = 500;
61
+ /** Потолок числа активных таймеров на сессию. */
62
+ export declare const TIMER_MAX_ACTIVE_PER_SESSION = 50;
63
+ /** Горизонт one-shot таймера, суток (30 дней). */
64
+ export declare const TIMER_ONE_SHOT_HORIZON_DAYS = 30;
65
+ /**
66
+ * Допуск для времени «в прошлом» при создании/правке будильника, секунды.
67
+ *
68
+ * Абсолютное время `at` в прошлом — ошибка ввода (частая опечатка), но
69
+ * небольшой допуск нужен из-за сетевой задержки и гонки «создал в 12:00:00.9
70
+ * на 12:00:00». Догон уже сохранённых записей после рестарта этим не
71
+ * ограничивается (там запись существовала до простоя).
72
+ */
73
+ export declare const TIMER_PAST_GRACE_SEC = 60;
74
+ /**
75
+ * Потолок интервала повтора `every` — 30 суток в секундах
76
+ * (совпадает с горизонтом one-shot: дольше — это уже не «каждые N секунд»).
77
+ */
78
+ export declare const TIMER_MAX_INTERVAL_SEC = 2592000;
79
+ /**
80
+ * Запись таймера/будильника (`tmr_<uuid>`).
81
+ *
82
+ * `projectId` и `sessionId` обязательны: инстансных автоматизаций не бывает
83
+ * (PROP-141, решение владельца) — каждая автоматизация привязана к проекту,
84
+ * а сообщение уходит в конкретную сессию. Проект хранится денормализованно
85
+ * (для выборок и RBAC — ADR-140).
86
+ */
87
+ export interface Timer {
88
+ /** `tmr_<uuid>`, уникален в пределах инстанса. */
89
+ id: string;
90
+ /** Вид автоматизации (таймер/будильник). */
91
+ kind: TimerKind;
92
+ /** Необязательное имя (карточка в панели «Автоматизация»). */
93
+ name?: string;
94
+ /** Комментарий (1…500 символов) — единственный «смысл» срабатывания. */
95
+ comment: string;
96
+ /** Проект автоматизации (обязателен — инстансных автоматизаций нет). */
97
+ projectId: string;
98
+ /** Сессия-получатель сообщения (обязательна). */
99
+ sessionId: string;
100
+ /** Владелец (принципал-человек; в standalone — `local`). */
101
+ ownerId: string;
102
+ /** Режим повтора. */
103
+ repeat: TimerRepeat;
104
+ /** Статус записи. */
105
+ status: TimerStatus;
106
+ /** Ближайшее срабатывание, ISO-8601 (вычисляет движок). */
107
+ firesAt: string;
108
+ /** Момент создания, ISO-8601. */
109
+ createdAt: string;
110
+ /** Момент последнего изменения, ISO-8601. */
111
+ updatedAt: string;
112
+ /** Момент фактического срабатывания, ISO-8601 (если сработал). */
113
+ firedAt?: string;
114
+ /** Текст последней ошибки доставки/срабатывания. */
115
+ lastError?: string;
116
+ }
117
+ /**
118
+ * Итог срабатывания таймера:
119
+ * - `ok` — доставлено;
120
+ * - `error` — ошибка доставки;
121
+ * - `skipped` — срабатывание пропущено (например, таймер отменён к моменту тика).
122
+ */
123
+ export type TimerFiringOutcome = 'ok' | 'error' | 'skipped';
124
+ /**
125
+ * Запись истории срабатываний (`tmf_<uuid>`) — append-only.
126
+ *
127
+ * `scheduledFor` — плановое время срабатывания, `firedAt` — фактическое,
128
+ * `lagMs` — расхождение (метрика «задержка срабатывания»). Дедуп по
129
+ * `(timerId, scheduledFor)` делает движок, а не порт (PROP-141, Часть B).
130
+ */
131
+ export interface TimerFiring {
132
+ /** `tmf_<uuid>`, уникален в пределах инстанса. */
133
+ id: string;
134
+ /** Таймер, к которому относится срабатывание. */
135
+ timerId: string;
136
+ /** Фактическое время срабатывания, ISO-8601. */
137
+ firedAt: string;
138
+ /** Плановое время срабатывания, ISO-8601. */
139
+ scheduledFor: string;
140
+ /** Задержка срабатывания относительно плана, мс (может быть отрицательной). */
141
+ lagMs: number;
142
+ /** Итог срабатывания. */
143
+ outcome: TimerFiringOutcome;
144
+ /** Сессия, в которую доставлено сообщение. */
145
+ sessionId: string;
146
+ }
147
+ /** Фильтр выборки таймеров (все условия — по «И»). */
148
+ export interface TimerFilter {
149
+ /** Сессия-получатель. */
150
+ sessionId?: string;
151
+ /** Проект автоматизации. */
152
+ projectId?: string;
153
+ /** Статус записи. */
154
+ status?: TimerStatus;
155
+ /** Вид автоматизации. */
156
+ kind?: TimerKind;
157
+ /** Смещение выборки (постраничный листинг, ADR-118 §4). */
158
+ offset?: number;
159
+ /** Потолок выборки. */
160
+ limit?: number;
161
+ }
162
+ /**
163
+ * Вход создания таймера — без `id`, таймстемпов и результата срабатывания
164
+ * (ими владеет порт/движок).
165
+ */
166
+ export interface TimerCreateInput {
167
+ /** Вид автоматизации. */
168
+ kind: TimerKind;
169
+ /** Необязательное имя. */
170
+ name?: string;
171
+ /** Комментарий (1…500 символов). */
172
+ comment: string;
173
+ /** Проект автоматизации (обязателен). */
174
+ projectId: string;
175
+ /** Сессия-получатель (обязательна). */
176
+ sessionId: string;
177
+ /** Владелец. */
178
+ ownerId: string;
179
+ /** Режим повтора. */
180
+ repeat: TimerRepeat;
181
+ /** Статус при создании (по умолчанию — `active`). */
182
+ status?: TimerStatus;
183
+ /** Ближайшее срабатывание, ISO-8601 (вычисляет вызывающий — движок). */
184
+ firesAt: string;
185
+ }
186
+ /**
187
+ * Частичная правка таймера. Неизменяемые поля (`id`, `projectId`,
188
+ * `sessionId`, `ownerId`, `createdAt`) в патче отсутствуют: смена проекта
189
+ * сессии — отдельная операция с явными последствиями (PROP-141, Часть D).
190
+ */
191
+ export interface TimerPatch {
192
+ /** Вид автоматизации. */
193
+ kind?: TimerKind;
194
+ /** Имя (`null` — сбросить). */
195
+ name?: string | null;
196
+ /** Комментарий. */
197
+ comment?: string;
198
+ /** Режим повтора. */
199
+ repeat?: TimerRepeat;
200
+ /** Статус. */
201
+ status?: TimerStatus;
202
+ /** Ближайшее срабатывание, ISO-8601. */
203
+ firesAt?: string;
204
+ /** Момент фактического срабатывания (`null` — сбросить). */
205
+ firedAt?: string | null;
206
+ /** Текст последней ошибки (`null` — сбросить). */
207
+ lastError?: string | null;
208
+ }
209
+ /** Время суток в формате `HH:MM` (00:00…23:59). */
210
+ export declare const TIMER_TIME_REGEX: RegExp;
211
+ /** Схема времени суток `HH:MM`. */
212
+ export declare const timerTimeSchema: z.ZodString;
213
+ /** Схема вида автоматизации. */
214
+ export declare const timerKindSchema: z.ZodEnum<{
215
+ timer: "timer";
216
+ alarm: "alarm";
217
+ }>;
218
+ /** Схема статуса таймера. */
219
+ export declare const timerStatusSchema: z.ZodEnum<{
220
+ cancelled: "cancelled";
221
+ active: "active";
222
+ paused: "paused";
223
+ fired: "fired";
224
+ }>;
225
+ /** Схема режима повтора. */
226
+ export declare const timerRepeatSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
227
+ mode: z.ZodLiteral<"once">;
228
+ }, z.core.$strict>, z.ZodObject<{
229
+ mode: z.ZodLiteral<"daily">;
230
+ time: z.ZodString;
231
+ timezone: z.ZodString;
232
+ }, z.core.$strict>, z.ZodObject<{
233
+ mode: z.ZodLiteral<"every">;
234
+ everySec: z.ZodNumber;
235
+ }, z.core.$strict>], "mode">;
236
+ /** Схема комментария таймера (1…500 символов). */
237
+ export declare const timerCommentSchema: z.ZodString;
238
+ /** Схема времени срабатывания (ISO-8601). */
239
+ export declare const timerTimestampSchema: z.ZodISODateTime;
240
+ /** Схема записи таймера (полная). */
241
+ export declare const timerSchema: z.ZodObject<{
242
+ id: z.ZodString;
243
+ kind: z.ZodEnum<{
244
+ timer: "timer";
245
+ alarm: "alarm";
246
+ }>;
247
+ name: z.ZodOptional<z.ZodString>;
248
+ comment: z.ZodString;
249
+ projectId: z.ZodString;
250
+ sessionId: z.ZodString;
251
+ ownerId: z.ZodString;
252
+ repeat: z.ZodDiscriminatedUnion<[z.ZodObject<{
253
+ mode: z.ZodLiteral<"once">;
254
+ }, z.core.$strict>, z.ZodObject<{
255
+ mode: z.ZodLiteral<"daily">;
256
+ time: z.ZodString;
257
+ timezone: z.ZodString;
258
+ }, z.core.$strict>, z.ZodObject<{
259
+ mode: z.ZodLiteral<"every">;
260
+ everySec: z.ZodNumber;
261
+ }, z.core.$strict>], "mode">;
262
+ status: z.ZodEnum<{
263
+ cancelled: "cancelled";
264
+ active: "active";
265
+ paused: "paused";
266
+ fired: "fired";
267
+ }>;
268
+ firesAt: z.ZodISODateTime;
269
+ createdAt: z.ZodISODateTime;
270
+ updatedAt: z.ZodISODateTime;
271
+ firedAt: z.ZodOptional<z.ZodISODateTime>;
272
+ lastError: z.ZodOptional<z.ZodString>;
273
+ }, z.core.$strip>;
274
+ /** Схема входа создания таймера. */
275
+ export declare const timerCreateInputSchema: z.ZodObject<{
276
+ kind: z.ZodEnum<{
277
+ timer: "timer";
278
+ alarm: "alarm";
279
+ }>;
280
+ name: z.ZodOptional<z.ZodString>;
281
+ comment: z.ZodString;
282
+ projectId: z.ZodString;
283
+ sessionId: z.ZodString;
284
+ ownerId: z.ZodString;
285
+ repeat: z.ZodDiscriminatedUnion<[z.ZodObject<{
286
+ mode: z.ZodLiteral<"once">;
287
+ }, z.core.$strict>, z.ZodObject<{
288
+ mode: z.ZodLiteral<"daily">;
289
+ time: z.ZodString;
290
+ timezone: z.ZodString;
291
+ }, z.core.$strict>, z.ZodObject<{
292
+ mode: z.ZodLiteral<"every">;
293
+ everySec: z.ZodNumber;
294
+ }, z.core.$strict>], "mode">;
295
+ status: z.ZodOptional<z.ZodEnum<{
296
+ cancelled: "cancelled";
297
+ active: "active";
298
+ paused: "paused";
299
+ fired: "fired";
300
+ }>>;
301
+ firesAt: z.ZodISODateTime;
302
+ }, z.core.$strip>;
303
+ /** Схема частичной правки таймера. */
304
+ export declare const timerPatchSchema: z.ZodObject<{
305
+ kind: z.ZodOptional<z.ZodEnum<{
306
+ timer: "timer";
307
+ alarm: "alarm";
308
+ }>>;
309
+ name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
310
+ comment: z.ZodOptional<z.ZodString>;
311
+ repeat: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
312
+ mode: z.ZodLiteral<"once">;
313
+ }, z.core.$strict>, z.ZodObject<{
314
+ mode: z.ZodLiteral<"daily">;
315
+ time: z.ZodString;
316
+ timezone: z.ZodString;
317
+ }, z.core.$strict>, z.ZodObject<{
318
+ mode: z.ZodLiteral<"every">;
319
+ everySec: z.ZodNumber;
320
+ }, z.core.$strict>], "mode">>;
321
+ status: z.ZodOptional<z.ZodEnum<{
322
+ cancelled: "cancelled";
323
+ active: "active";
324
+ paused: "paused";
325
+ fired: "fired";
326
+ }>>;
327
+ firesAt: z.ZodOptional<z.ZodISODateTime>;
328
+ firedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
329
+ lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
330
+ }, z.core.$strip>;
331
+ /** Схема записи срабатывания таймера. */
332
+ export declare const timerFiringSchema: z.ZodObject<{
333
+ id: z.ZodString;
334
+ timerId: z.ZodString;
335
+ firedAt: z.ZodISODateTime;
336
+ scheduledFor: z.ZodISODateTime;
337
+ lagMs: z.ZodNumber;
338
+ outcome: z.ZodEnum<{
339
+ error: "error";
340
+ ok: "ok";
341
+ skipped: "skipped";
342
+ }>;
343
+ sessionId: z.ZodString;
344
+ }, z.core.$strip>;
345
+ /**
346
+ * Тело создания таймера/будильника через HTTP (PROP-141, этап 5 B-2).
347
+ *
348
+ * Отличие от записи `Timer`/`timerCreateInputSchema`: это **интент** — правило
349
+ * первого срабатывания, а не вычисленная метка времени:
350
+ * - `repeat.mode = 'once'` + `kind:'timer'` — относительная задержка `delaySec`;
351
+ * - `repeat.mode = 'once'` + `kind:'alarm'` — абсолютное время `at`;
352
+ * - `repeat.mode = 'daily'|'every'` — правило повтора (метку вычисляет движок).
353
+ *
354
+ * `projectId` в теле необязателен: сервер выводит его из сессии
355
+ * (`sessionId`) и сверяет с переданным (несовпадение → 400). `ownerId` в теле
356
+ * **нет**: владелец — текущий пользователь (для service-key — `service:<keyId>`).
357
+ */
358
+ export declare const timerIntentRequestSchema: z.ZodObject<{
359
+ kind: z.ZodEnum<{
360
+ timer: "timer";
361
+ alarm: "alarm";
362
+ }>;
363
+ name: z.ZodOptional<z.ZodString>;
364
+ comment: z.ZodString;
365
+ sessionId: z.ZodString;
366
+ projectId: z.ZodOptional<z.ZodString>;
367
+ repeat: z.ZodDiscriminatedUnion<[z.ZodObject<{
368
+ mode: z.ZodLiteral<"once">;
369
+ }, z.core.$strict>, z.ZodObject<{
370
+ mode: z.ZodLiteral<"daily">;
371
+ time: z.ZodString;
372
+ timezone: z.ZodString;
373
+ }, z.core.$strict>, z.ZodObject<{
374
+ mode: z.ZodLiteral<"every">;
375
+ everySec: z.ZodNumber;
376
+ }, z.core.$strict>], "mode">;
377
+ delaySec: z.ZodOptional<z.ZodNumber>;
378
+ at: z.ZodOptional<z.ZodISODateTime>;
379
+ allow_duplicate: z.ZodOptional<z.ZodBoolean>;
380
+ }, z.core.$strip>;
381
+ /**
382
+ * Тело частичной правки таймера через HTTP (PROP-141, этап 5 B-2).
383
+ *
384
+ * Правятся только «смысловые» поля: `name` (`null` — сбросить), `comment`
385
+ * и `repeat` (смена правила повтора пересчитывает ближайшее срабатывание —
386
+ * это делает движок). Статус (`status`) и метка времени (`firesAt`) — не в
387
+ * HTTP-контракте: их меняют операции паузы/возобновления.
388
+ */
389
+ export declare const timerPatchRequestSchema: z.ZodObject<{
390
+ name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
391
+ comment: z.ZodOptional<z.ZodString>;
392
+ repeat: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
393
+ mode: z.ZodLiteral<"once">;
394
+ }, z.core.$strict>, z.ZodObject<{
395
+ mode: z.ZodLiteral<"daily">;
396
+ time: z.ZodString;
397
+ timezone: z.ZodString;
398
+ }, z.core.$strict>, z.ZodObject<{
399
+ mode: z.ZodLiteral<"every">;
400
+ everySec: z.ZodNumber;
401
+ }, z.core.$strict>], "mode">>;
402
+ }, z.core.$strip>;
@@ -0,0 +1,166 @@
1
+ /**
2
+ * PROP-141 (Часть B): контракты таймеров и будильников.
3
+ *
4
+ * Таймер и будильник — **один тип** с двумя видами (`kind`): таймер
5
+ * относительный («через 15 минут»), будильник — абсолютный/повторяющийся
6
+ * («завтра в 09:00», «каждые 10 минут»). Отличие от расписания (ADR-051):
7
+ * у расписания есть **свой текст задания**, здесь несёт только комментарий —
8
+ * смысл срабатывания восстанавливает сам агент по комментарию и истории.
9
+ *
10
+ * Здесь только контракты (типы + Zod-схемы) — без бизнес-логики: вычисление
11
+ * `firesAt`, догон (catch-up), дедуп и доставка живут в core (`engine/timers/`,
12
+ * следующий этап PROP-141). Персистентность — доменные порты
13
+ * `TimerRepository`/`TimerFiringRepository` (ADR-096).
14
+ */
15
+ import { z } from 'zod';
16
+ /** Канонический набор видов автоматизации. */
17
+ export const TIMER_KINDS = ['timer', 'alarm'];
18
+ /** Канонический набор режимов повтора. */
19
+ export const TIMER_REPEAT_MODES = ['once', 'daily', 'every'];
20
+ /** Канонический набор статусов таймера. */
21
+ export const TIMER_STATUSES = ['active', 'paused', 'fired', 'cancelled'];
22
+ /**
23
+ * Минимальный интервал/повтор — 10 секунд (решение владельца, PROP-141).
24
+ * Интервал меньше — заведомо «мгновенное» повторение, а не автоматизация.
25
+ */
26
+ export const TIMER_MIN_INTERVAL_SEC = 10;
27
+ /** Потолок длины комментария (единственный «смысл» срабатывания). */
28
+ export const TIMER_COMMENT_MAX = 500;
29
+ /** Потолок числа активных таймеров на сессию. */
30
+ export const TIMER_MAX_ACTIVE_PER_SESSION = 50;
31
+ /** Горизонт one-shot таймера, суток (30 дней). */
32
+ export const TIMER_ONE_SHOT_HORIZON_DAYS = 30;
33
+ /**
34
+ * Допуск для времени «в прошлом» при создании/правке будильника, секунды.
35
+ *
36
+ * Абсолютное время `at` в прошлом — ошибка ввода (частая опечатка), но
37
+ * небольшой допуск нужен из-за сетевой задержки и гонки «создал в 12:00:00.9
38
+ * на 12:00:00». Догон уже сохранённых записей после рестарта этим не
39
+ * ограничивается (там запись существовала до простоя).
40
+ */
41
+ export const TIMER_PAST_GRACE_SEC = 60;
42
+ /**
43
+ * Потолок интервала повтора `every` — 30 суток в секундах
44
+ * (совпадает с горизонтом one-shot: дольше — это уже не «каждые N секунд»).
45
+ */
46
+ export const TIMER_MAX_INTERVAL_SEC = 2_592_000;
47
+ // ── Zod-схемы ───────────────────────────────────────────────────────────────
48
+ /** Время суток в формате `HH:MM` (00:00…23:59). */
49
+ export const TIMER_TIME_REGEX = /^([01]\d|2[0-3]):([0-5]\d)$/;
50
+ /** Схема времени суток `HH:MM`. */
51
+ export const timerTimeSchema = z
52
+ .string()
53
+ .regex(TIMER_TIME_REGEX, 'Ожидается время в формате HH:MM (часы 00–23, минуты 00–59)');
54
+ /** Схема вида автоматизации. */
55
+ export const timerKindSchema = z.enum(TIMER_KINDS);
56
+ /** Схема статуса таймера. */
57
+ export const timerStatusSchema = z.enum(TIMER_STATUSES);
58
+ /** Схема режима повтора. */
59
+ export const timerRepeatSchema = z.discriminatedUnion('mode', [
60
+ z.object({ mode: z.literal('once') }).strict(),
61
+ z.object({
62
+ mode: z.literal('daily'),
63
+ time: timerTimeSchema,
64
+ timezone: z.string().min(1),
65
+ }).strict(),
66
+ z.object({
67
+ mode: z.literal('every'),
68
+ everySec: z
69
+ .number()
70
+ .int()
71
+ .min(TIMER_MIN_INTERVAL_SEC)
72
+ .max(TIMER_MAX_INTERVAL_SEC),
73
+ }).strict(),
74
+ ]);
75
+ /** Схема комментария таймера (1…500 символов). */
76
+ export const timerCommentSchema = z.string().min(1).max(TIMER_COMMENT_MAX);
77
+ /** Схема времени срабатывания (ISO-8601). */
78
+ export const timerTimestampSchema = z.iso.datetime({ offset: true });
79
+ /** Схема записи таймера (полная). */
80
+ export const timerSchema = z.object({
81
+ id: z.string().min(1),
82
+ kind: timerKindSchema,
83
+ name: z.string().min(1).optional(),
84
+ comment: timerCommentSchema,
85
+ projectId: z.string().min(1),
86
+ sessionId: z.string().min(1),
87
+ ownerId: z.string().min(1),
88
+ repeat: timerRepeatSchema,
89
+ status: timerStatusSchema,
90
+ firesAt: timerTimestampSchema,
91
+ createdAt: timerTimestampSchema,
92
+ updatedAt: timerTimestampSchema,
93
+ firedAt: timerTimestampSchema.optional(),
94
+ lastError: z.string().optional(),
95
+ });
96
+ /** Схема входа создания таймера. */
97
+ export const timerCreateInputSchema = z.object({
98
+ kind: timerKindSchema,
99
+ name: z.string().min(1).optional(),
100
+ comment: timerCommentSchema,
101
+ projectId: z.string().min(1),
102
+ sessionId: z.string().min(1),
103
+ ownerId: z.string().min(1),
104
+ repeat: timerRepeatSchema,
105
+ status: timerStatusSchema.optional(),
106
+ firesAt: timerTimestampSchema,
107
+ });
108
+ /** Схема частичной правки таймера. */
109
+ export const timerPatchSchema = z.object({
110
+ kind: timerKindSchema.optional(),
111
+ name: z.string().min(1).nullable().optional(),
112
+ comment: timerCommentSchema.optional(),
113
+ repeat: timerRepeatSchema.optional(),
114
+ status: timerStatusSchema.optional(),
115
+ firesAt: timerTimestampSchema.optional(),
116
+ firedAt: timerTimestampSchema.nullable().optional(),
117
+ lastError: z.string().nullable().optional(),
118
+ });
119
+ /** Схема записи срабатывания таймера. */
120
+ export const timerFiringSchema = z.object({
121
+ id: z.string().min(1),
122
+ timerId: z.string().min(1),
123
+ firedAt: timerTimestampSchema,
124
+ scheduledFor: timerTimestampSchema,
125
+ lagMs: z.number().int(),
126
+ outcome: z.enum(['ok', 'error', 'skipped']),
127
+ sessionId: z.string().min(1),
128
+ });
129
+ /**
130
+ * Тело создания таймера/будильника через HTTP (PROP-141, этап 5 B-2).
131
+ *
132
+ * Отличие от записи `Timer`/`timerCreateInputSchema`: это **интент** — правило
133
+ * первого срабатывания, а не вычисленная метка времени:
134
+ * - `repeat.mode = 'once'` + `kind:'timer'` — относительная задержка `delaySec`;
135
+ * - `repeat.mode = 'once'` + `kind:'alarm'` — абсолютное время `at`;
136
+ * - `repeat.mode = 'daily'|'every'` — правило повтора (метку вычисляет движок).
137
+ *
138
+ * `projectId` в теле необязателен: сервер выводит его из сессии
139
+ * (`sessionId`) и сверяет с переданным (несовпадение → 400). `ownerId` в теле
140
+ * **нет**: владелец — текущий пользователь (для service-key — `service:<keyId>`).
141
+ */
142
+ export const timerIntentRequestSchema = z.object({
143
+ kind: timerKindSchema,
144
+ name: z.string().min(1).optional(),
145
+ comment: timerCommentSchema,
146
+ sessionId: z.string().min(1),
147
+ projectId: z.string().min(1).optional(),
148
+ repeat: timerRepeatSchema,
149
+ delaySec: z.number().int().optional(),
150
+ at: timerTimestampSchema.optional(),
151
+ /** Разрешить семантический дубликат (см. ADR-141); по умолчанию — нет. */
152
+ allow_duplicate: z.boolean().optional(),
153
+ });
154
+ /**
155
+ * Тело частичной правки таймера через HTTP (PROP-141, этап 5 B-2).
156
+ *
157
+ * Правятся только «смысловые» поля: `name` (`null` — сбросить), `comment`
158
+ * и `repeat` (смена правила повтора пересчитывает ближайшее срабатывание —
159
+ * это делает движок). Статус (`status`) и метка времени (`firesAt`) — не в
160
+ * HTTP-контракте: их меняют операции паузы/возобновления.
161
+ */
162
+ export const timerPatchRequestSchema = z.object({
163
+ name: z.string().min(1).nullable().optional(),
164
+ comment: timerCommentSchema.optional(),
165
+ repeat: timerRepeatSchema.optional(),
166
+ });