@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
@@ -1,6 +1,6 @@
1
1
  import { load as parseYaml, dump as dumpYaml } from 'js-yaml';
2
2
  /**
3
- * ADR-046 §3.1: толерантный парсер YAML-frontmatter `SKILL.md`.
3
+ * ADR-126 §3: толерантный парсер YAML-frontmatter `SKILL.md`.
4
4
  *
5
5
  * - Неизвестные ключи — не ошибка (совместимость Anthropic/opencode/Claude Code).
6
6
  * - Невалидный YAML — фиксируется issue, но не бросает исключение.
@@ -24,12 +24,40 @@ export interface AgentDefinition {
24
24
  effort?: EffortLevel;
25
25
  agentMode?: AgentMode | AgentMode[];
26
26
  maxSteps?: number;
27
+ /**
28
+ * PROP-135 Ф6a: профиль исполнения агента (`execution.remote.profiles`).
29
+ * Приоритет выбора профиля: сессия → агент → проект → `defaultProfile`.
30
+ * Не задан — профиль берётся у проекта/инстанса.
31
+ */
32
+ executorProfile?: string;
33
+ /**
34
+ * PROP-135 Ф6a: **потолок** профилей исполнения агента: если массив задан,
35
+ * агент не может исполняться на профиле вне списка (нарушение — fail-closed:
36
+ * запрещённый профиль не выбирается, инстанс-дефолт — **не исключение**,
37
+ * вне списка профилей нет вовсе). Пустой массив — «профилей нет»; массив не
38
+ * задан (`undefined`) — потолок области не задан (ограничения нет).
39
+ */
40
+ allowedProfiles?: string[];
41
+ /**
42
+ * PROP-135 (браузерный контур): профиль браузерного пула агента
43
+ * (`execution.remote.browserProfiles`). Приоритет выбора: сессия → агент →
44
+ * проект → инстанс-дефолт (`execution.remote.browserProfile`). Не задан —
45
+ * наследуется. Отдельный контур: имя проверяется по браузерному каталогу, а
46
+ * не по exec-каталогу (`allowedProfiles`).
47
+ */
48
+ browserProfile?: string;
49
+ /**
50
+ * PROP-135 (браузерный контур): **потолок** браузерных профилей агента.
51
+ * Заданный список — профиль обязан в него входить (пустой — «профилей
52
+ * нет»); не задан — потолок не задан.
53
+ */
54
+ allowedBrowserProfiles?: string[];
27
55
  isOverridden: boolean;
28
56
  icon?: string;
29
57
  color?: string;
30
58
  description?: string;
31
59
  /**
32
- * ADR-046 §6.2: группы агентов для привязки скиллов
60
+ * ADR-126 §9: группы агентов для привязки скиллов
33
61
  * (`metadata.synth.groups`). Пусто/не задано — скилл с непустым `groups`
34
62
  * не привязан к агенту.
35
63
  */
@@ -114,6 +114,13 @@ export type AuthorityGrantConstraints = z.infer<typeof authorityGrantConstraints
114
114
  * Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
115
115
  * `roles[]` — роли, которые носитель принципала предъявляет (содержательные
116
116
  * роли приезжают контентом; глобальные роли инстанса — отдельная ось).
117
+ *
118
+ * ADR-140 Ф2: `groups[]` — группы пользователя (снимок claim'а IdP на момент
119
+ * приёма ввода, ADR-106 Ф4). Поле **аддитивное и необязательное**: старое
120
+ * сохранённое сообщение без него парсится (`undefined`), отсутствие поля =
121
+ * «групп нет» (fail-closed); потребители нормализуют `?? []`. На права влияет
122
+ * только через единый резолвер доступа (`resolveProjectAccess`,
123
+ * ADR-140/PROP-133).
117
124
  */
118
125
  export declare const authorityPrincipalSchema: z.ZodObject<{
119
126
  kind: z.ZodEnum<{
@@ -125,6 +132,7 @@ export declare const authorityPrincipalSchema: z.ZodObject<{
125
132
  }>;
126
133
  id: z.ZodString;
127
134
  roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
135
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
128
136
  }, z.core.$strict>;
129
137
  export type AuthorityPrincipal = z.infer<typeof authorityPrincipalSchema>;
130
138
  /**
@@ -243,6 +251,7 @@ export declare const authorityTurnSchema: z.ZodObject<{
243
251
  }>;
244
252
  id: z.ZodString;
245
253
  roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
254
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
246
255
  }, z.core.$strict>;
247
256
  agentId: z.ZodOptional<z.ZodString>;
248
257
  ceiling: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -288,6 +297,7 @@ export declare const authorityApprovalSchema: z.ZodObject<{
288
297
  }>;
289
298
  id: z.ZodString;
290
299
  roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
300
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
291
301
  }, z.core.$strict>;
292
302
  action: z.ZodString;
293
303
  target: z.ZodObject<{
@@ -155,12 +155,20 @@ export const authorityGrantConstraintsSchema = z
155
155
  * Принципал — тот, от чьего имени исполняется ход (ADR-106 §«Модель»).
156
156
  * `roles[]` — роли, которые носитель принципала предъявляет (содержательные
157
157
  * роли приезжают контентом; глобальные роли инстанса — отдельная ось).
158
+ *
159
+ * ADR-140 Ф2: `groups[]` — группы пользователя (снимок claim'а IdP на момент
160
+ * приёма ввода, ADR-106 Ф4). Поле **аддитивное и необязательное**: старое
161
+ * сохранённое сообщение без него парсится (`undefined`), отсутствие поля =
162
+ * «групп нет» (fail-closed); потребители нормализуют `?? []`. На права влияет
163
+ * только через единый резолвер доступа (`resolveProjectAccess`,
164
+ * ADR-140/PROP-133).
158
165
  */
159
166
  export const authorityPrincipalSchema = z
160
167
  .object({
161
168
  kind: authorityPrincipalKindSchema,
162
169
  id: z.string().min(1).max(256),
163
170
  roles: z.array(z.string().min(1).max(128)).default([]),
171
+ groups: z.array(z.string().min(1).max(128)).optional(),
164
172
  })
165
173
  .strict();
166
174
  /**
@@ -1,6 +1,6 @@
1
1
  import type { WorktreeUpdateAction } from './worktree.js';
2
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
+ 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' | 'message.mentioned' | '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' | 'background.auto_detached' | 'child.started' | 'child.completed' | 'child.failed' | 'child.cancelled' | 'terminal.created' | 'terminal.updated' | 'terminal.exited' | 'terminal.deleted' | 'timer.created' | 'timer.updated' | 'timer.fired' | 'timer.cancelled' | 'timer.deleted' | 'error';
4
4
  export interface BusEvent {
5
5
  type: EventType;
6
6
  sessionId: string;
@@ -77,6 +77,21 @@ export type MessageUpdatedEventData = {
77
77
  /** Новое значение `disabled` (toggle/batch toggle/retry). */
78
78
  disabled?: boolean;
79
79
  };
80
+ /**
81
+ * Payload события `message.mentioned` (ADR-126 §2) — сообщение адресовано
82
+ * пользователю.
83
+ *
84
+ * `user_ids` — участники, которых нужно уведомить: отправитель исключён
85
+ * (self-mention допускается, но уведомление себе не отправляется).
86
+ */
87
+ export type MessageMentionedEventData = {
88
+ /** id сообщения, в котором упомянут пользователь. */
89
+ message_id: string;
90
+ /** id упомянутых пользователей (получателей уведомления). */
91
+ user_ids: string[];
92
+ /** id сессии (канал события). */
93
+ session_id: string;
94
+ };
80
95
  /** Payload события `session.messages.cleared` — история очищена, кроме закреплённых. */
81
96
  export type SessionMessagesClearedEventData = {
82
97
  session_id: string;
@@ -85,3 +100,74 @@ export type SessionMessagesClearedEventData = {
85
100
  export type ProjectChangedEventData = {
86
101
  project_id: string;
87
102
  };
103
+ /**
104
+ * Payload события `terminal.created` — терминал открыт.
105
+ *
106
+ * Идентификаторы — snake_case (как у остальных payload'ов шины).
107
+ */
108
+ export interface TerminalCreatedEventData {
109
+ /** Идентификатор терминала (`term_<uuid>`). */
110
+ terminal_id: string;
111
+ /** Проект-владелец терминала. */
112
+ project_id: string;
113
+ /** Привязанная сессия (необязательно). */
114
+ session_id?: string;
115
+ /** Статус терминала (`starting`/`running`). */
116
+ status: string;
117
+ /** Ширина (колонки). */
118
+ cols: number;
119
+ /** Высота (строки). */
120
+ rows: number;
121
+ /** Заголовок вкладки (необязательно). */
122
+ title?: string;
123
+ }
124
+ /**
125
+ * Payload события `terminal.updated` — изменились метаданные терминала
126
+ * (размер, заголовок, привязка к сессии).
127
+ */
128
+ export interface TerminalUpdatedEventData extends TerminalCreatedEventData {
129
+ /** Код выхода (только после выхода). */
130
+ exit_code?: number;
131
+ /** Сигнал завершения (только после выхода). */
132
+ signal?: string;
133
+ }
134
+ /**
135
+ * Payload события `terminal.exited` — процесс терминала завершился.
136
+ */
137
+ export interface TerminalExitedEventData extends TerminalUpdatedEventData {
138
+ /** Причина закрытия (`user`/`idle`/`disabled`/`exited`). */
139
+ reason?: string;
140
+ }
141
+ /**
142
+ * Payload события `terminal.deleted` — запись терминала удалена из реестра.
143
+ */
144
+ export interface TerminalDeletedEventData extends TerminalUpdatedEventData {
145
+ /** Причина удаления (`user`/`idle`/`disabled`). */
146
+ reason?: string;
147
+ }
148
+ /**
149
+ * Payload событий `timer.created`/`timer.updated`/`timer.fired`/`timer.cancelled`/
150
+ * `timer.deleted`.
151
+ *
152
+ * Идентификаторы — snake_case (как у остальных payload'ов шины).
153
+ */
154
+ export interface TimerEventData {
155
+ /** Id записи: `tmr_<uuid>` для таймера, `alm_<uuid>` для будильника. */
156
+ timer_id: string;
157
+ /** Вид автоматизации (`timer`/`alarm`). */
158
+ kind: string;
159
+ /** Проект автоматизации. */
160
+ project_id: string;
161
+ /** Сессия-получатель сообщения. */
162
+ session_id: string;
163
+ /** Статус записи (`active`/`paused`/`fired`/`cancelled`). */
164
+ status?: string;
165
+ /** Ближайшее срабатывание (ISO-8601). */
166
+ fires_at?: string;
167
+ /** Момент фактического срабатывания (ISO-8601) — для `timer.fired`. */
168
+ fired_at?: string;
169
+ /** Плановое время срабатывания (ISO-8601) — для `timer.fired`. */
170
+ scheduled_for?: string;
171
+ /** Имя автоматизации (необязательное). */
172
+ name?: string;
173
+ }
@@ -337,7 +337,7 @@ export declare function isCatalogIndexDocument(raw: unknown): boolean;
337
337
  * строгим контрактом `catalogEntrySchema`, невалидные пропускаются молча;
338
338
  * 2. `{ skills: [...] }` — записи скиллов;
339
339
  * 3. Голый массив `[{ name, path? }]` — legacy-формат внешнего каталога скиллов
340
- * (ADR-046 §4.3).
340
+ * (ADR-126 §7).
341
341
  *
342
342
  * Формы 2 и 3 — это **скиллы**: `kind: 'pack'`, `packType: 'skills'`,
343
343
  * `trust_level: 'community'`, `source: 'registry'`, `identifier` = `path`
@@ -368,7 +368,7 @@ export function isCatalogIndexDocument(raw) {
368
368
  * строгим контрактом `catalogEntrySchema`, невалидные пропускаются молча;
369
369
  * 2. `{ skills: [...] }` — записи скиллов;
370
370
  * 3. Голый массив `[{ name, path? }]` — legacy-формат внешнего каталога скиллов
371
- * (ADR-046 §4.3).
371
+ * (ADR-126 §7).
372
372
  *
373
373
  * Формы 2 и 3 — это **скиллы**: `kind: 'pack'`, `packType: 'skills'`,
374
374
  * `trust_level: 'community'`, `source: 'registry'`, `identifier` = `path`
@@ -0,0 +1,91 @@
1
+ /**
2
+ * PROP-136 (слайс 136a): append-only аудит **исполнений** команд
3
+ * (`execute_shell`/`sandbox_exec`).
4
+ *
5
+ * Shell — произвольный код, поэтому вместо мнимой изоляции вводится
6
+ * наблюдаемость: на каждый запуск пишется две записи — `started` (до запуска)
7
+ * и `finished` (после), связанные одним `id`. Тела вывода не пишутся — только
8
+ * размер, hash и признак обрезки. Команда хранится **обезличенной** (карта
9
+ * обфускации сессии + редакция значений секретов) и обрезанной до
10
+ * `COMMAND_AUDIT_MAX_COMMAND_BYTES`.
11
+ *
12
+ * Отдельный контракт, а не `SecurityAuditEntry`: тот описывает изменения
13
+ * политик (before/after), а здесь — факт исполнения.
14
+ */
15
+ /**
16
+ * Тулы, исполнение которых попадает в журнал (PROP-136).
17
+ *
18
+ * Кроме шелл-тулов — терминальные действия (PROP-132): `terminal.open`
19
+ * (открытие PTY), `terminal.input` (кадр ввода), `terminal.close` (закрытие).
20
+ * Их пишет терминальный сервис через тот же журнал (адаптер
21
+ * `createCommandAuditTerminalSink`) — те же метаданные, без содержимого.
22
+ *
23
+ * ADR-126 §5: `script.run` — запуск объявленного скрипта проекта (`!`).
24
+ * Запись несёт **только метаданные**: имя скрипта, cwd, число аргументов
25
+ * (сами аргументы — не пишутся), origin (`user`/`agent`), проект/сессия.
26
+ */
27
+ export declare const COMMAND_AUDIT_TOOLS: readonly ["execute_shell", "sandbox_exec", "terminal.open", "terminal.input", "terminal.close", "script.run"];
28
+ export type CommandAuditTool = (typeof COMMAND_AUDIT_TOOLS)[number];
29
+ /** Решение permission-слоя, при котором команда исполнялась. */
30
+ export declare const COMMAND_AUDIT_DECISIONS: readonly ["allow", "deny", "ask"];
31
+ export type CommandAuditDecision = (typeof COMMAND_AUDIT_DECISIONS)[number];
32
+ /** Фаза записи: до запуска и после завершения. */
33
+ export declare const COMMAND_AUDIT_PHASES: readonly ["started", "finished"];
34
+ export type CommandAuditPhase = (typeof COMMAND_AUDIT_PHASES)[number];
35
+ /** Кто принял решение об исполнении (PROP-136b: `policy` — внешний чекер). */
36
+ export declare const COMMAND_AUDIT_DECIDED_BY: readonly ["permission", "policy"];
37
+ export type CommandAuditDecidedBy = (typeof COMMAND_AUDIT_DECIDED_BY)[number];
38
+ /**
39
+ * Вердикт внешнего чекера команд в записи журнала (PROP-136b, слайс 136b-2a).
40
+ *
41
+ * Аддитивное поле: без чекера (`decidedBy: 'permission'`) его нет. `kind` —
42
+ * провайдер (`http`/`opa`), `ruleId` — сработавшее правило, `latencyMs` —
43
+ * длительность сетевой проверки (кэш — `0`), `action` — вердикт.
44
+ */
45
+ export interface CommandAuditProviderVerdict {
46
+ kind: string;
47
+ ruleId?: string;
48
+ latencyMs?: number;
49
+ action: 'allow' | 'deny';
50
+ }
51
+ /** Предел сохраняемой команды, байт (полная обезличенная строка хешируется). */
52
+ export declare const COMMAND_AUDIT_MAX_COMMAND_BYTES = 4096;
53
+ /** Срок хранения журнала по умолчанию, дней. */
54
+ export declare const DEFAULT_COMMAND_AUDIT_RETENTION_DAYS = 30;
55
+ /**
56
+ * Запись журнала исполнений.
57
+ *
58
+ * `id` — один на пару `started`/`finished`; `command`/`commandHash` —
59
+ * обезличенная команда (у `sandbox_exec` — `commands.join(' && ')`).
60
+ */
61
+ export interface CommandAuditEntry {
62
+ /** `execution_id` — один на пару `started`/`finished`. */
63
+ id: string;
64
+ /** Время записи, ISO-8601. */
65
+ ts: string;
66
+ sessionId?: string;
67
+ projectId?: string;
68
+ actor?: string;
69
+ agentRole?: string;
70
+ profile?: string;
71
+ tool: CommandAuditTool;
72
+ /** Команда: обезличена, ≤ `COMMAND_AUDIT_MAX_COMMAND_BYTES`. */
73
+ command: string;
74
+ /** sha256 полной обезличенной команды (до обрезки). */
75
+ commandHash: string;
76
+ cwd: string;
77
+ background: boolean;
78
+ decision: CommandAuditDecision;
79
+ decidedBy: CommandAuditDecidedBy;
80
+ matchedRule?: string;
81
+ /** PROP-136b: вердикт внешнего чекера команд (нет — решение permission-слоя). */
82
+ provider?: CommandAuditProviderVerdict;
83
+ /** PROP-136b: причина отказа/пропуска чекера (без секретов; EN). */
84
+ reason?: string;
85
+ durationMs?: number;
86
+ exitCode?: number;
87
+ bytesOut?: number;
88
+ truncated?: boolean;
89
+ outputSha256?: string;
90
+ phase: CommandAuditPhase;
91
+ }
@@ -0,0 +1,44 @@
1
+ /**
2
+ * PROP-136 (слайс 136a): append-only аудит **исполнений** команд
3
+ * (`execute_shell`/`sandbox_exec`).
4
+ *
5
+ * Shell — произвольный код, поэтому вместо мнимой изоляции вводится
6
+ * наблюдаемость: на каждый запуск пишется две записи — `started` (до запуска)
7
+ * и `finished` (после), связанные одним `id`. Тела вывода не пишутся — только
8
+ * размер, hash и признак обрезки. Команда хранится **обезличенной** (карта
9
+ * обфускации сессии + редакция значений секретов) и обрезанной до
10
+ * `COMMAND_AUDIT_MAX_COMMAND_BYTES`.
11
+ *
12
+ * Отдельный контракт, а не `SecurityAuditEntry`: тот описывает изменения
13
+ * политик (before/after), а здесь — факт исполнения.
14
+ */
15
+ /**
16
+ * Тулы, исполнение которых попадает в журнал (PROP-136).
17
+ *
18
+ * Кроме шелл-тулов — терминальные действия (PROP-132): `terminal.open`
19
+ * (открытие PTY), `terminal.input` (кадр ввода), `terminal.close` (закрытие).
20
+ * Их пишет терминальный сервис через тот же журнал (адаптер
21
+ * `createCommandAuditTerminalSink`) — те же метаданные, без содержимого.
22
+ *
23
+ * ADR-126 §5: `script.run` — запуск объявленного скрипта проекта (`!`).
24
+ * Запись несёт **только метаданные**: имя скрипта, cwd, число аргументов
25
+ * (сами аргументы — не пишутся), origin (`user`/`agent`), проект/сессия.
26
+ */
27
+ export const COMMAND_AUDIT_TOOLS = [
28
+ 'execute_shell',
29
+ 'sandbox_exec',
30
+ 'terminal.open',
31
+ 'terminal.input',
32
+ 'terminal.close',
33
+ 'script.run',
34
+ ];
35
+ /** Решение permission-слоя, при котором команда исполнялась. */
36
+ export const COMMAND_AUDIT_DECISIONS = ['allow', 'deny', 'ask'];
37
+ /** Фаза записи: до запуска и после завершения. */
38
+ export const COMMAND_AUDIT_PHASES = ['started', 'finished'];
39
+ /** Кто принял решение об исполнении (PROP-136b: `policy` — внешний чекер). */
40
+ export const COMMAND_AUDIT_DECIDED_BY = ['permission', 'policy'];
41
+ /** Предел сохраняемой команды, байт (полная обезличенная строка хешируется). */
42
+ export const COMMAND_AUDIT_MAX_COMMAND_BYTES = 4096;
43
+ /** Срок хранения журнала по умолчанию, дней. */
44
+ export const DEFAULT_COMMAND_AUDIT_RETENTION_DAYS = 30;
@@ -1,10 +1,10 @@
1
1
  import type { SkillScope, SkillLevel } from './skills.js';
2
2
  import type { PermissionConfig } from './permission.js';
3
3
  /**
4
- * ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
4
+ * ADR-126 §1: slash-команды и bundles — контракты. Здесь только типы (без
5
5
  * бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
6
6
  */
7
- /** Вид команды (ADR-046 §7.2). */
7
+ /** Вид команды (ADR-126 §1). */
8
8
  export declare const COMMAND_KINDS: readonly ["builtin", "template", "skill", "bundle"];
9
9
  export type CommandKind = (typeof COMMAND_KINDS)[number];
10
10
  /** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
@@ -17,7 +17,7 @@ export type CommandActor = (typeof COMMAND_ACTORS)[number];
17
17
  export type CommandDiagnosticLevel = 'error' | 'warning' | 'info';
18
18
  /** Коды диагностики команд/бандлов (только реально эмитируемые). */
19
19
  export type CommandIssueCode = 'invalid-frontmatter' | 'missing-name' | 'shadowed' | 'collision' | 'invalid-bundle' | 'missing-skill' | 'read-error'
20
- /** ADR-046 §4.4/§7.1: проектный каталог недоверенный — команда не грузится. */
20
+ /** ADR-126 §9/§7.1: проектный каталог недоверенный — команда не грузится. */
21
21
  | 'untrusted';
22
22
  /** Диагностика реестра команд (видна в `GET /api/v2/commands?diagnostics=1`). */
23
23
  export interface CommandDiagnostic {
@@ -30,7 +30,7 @@ export interface CommandDiagnostic {
30
30
  path?: string;
31
31
  }
32
32
  /**
33
- * YAML-группа скиллов (ADR-046 §7.3). `/bundle-name` грузит N тел одним
33
+ * YAML-группа скиллов (ADR-126 §14). `/bundle-name` грузит N тел одним
34
34
  * сообщением; bundle побеждает одноимённый skill.
35
35
  */
36
36
  export interface SkillBundle {
@@ -56,10 +56,20 @@ export interface CommandSummary {
56
56
  available: boolean;
57
57
  unavailableReason?: 'capabilities' | 'denied';
58
58
  }
59
- /** Статус результата резолвинга команды. */
59
+ /**
60
+ * Статус результата резолвинга команды. `skill` — legacy: `CommandService`
61
+ * больше не резолвит скиллы через `/` (ADR-126 §7).
62
+ */
60
63
  export type CommandResolveStatus = 'builtin' | 'prompt' | 'template' | 'skill' | 'bundle' | 'summarization' | 'unknown' | 'denied' | 'unavailable';
61
64
  /**
62
- * Результат резолвинга `/`-команды (ADR-046 §7.1).
65
+ * ADR-119: профиль сжатия контекста для ручного запуска.
66
+ *
67
+ * - `summarization` — итоги беседы (`/summary`);
68
+ * - `compaction` — рабочее состояние по коду/проекту (`/compact`, ADR-126 §1).
69
+ */
70
+ export type CommandCompressionMode = 'summarization' | 'compaction';
71
+ /**
72
+ * Результат резолвинга `/`-команды (ADR-126 §14).
63
73
  *
64
74
  * - `builtin` — локальный ответ (`output`), LLM не вызывается; user+assistant
65
75
  * сообщения помечаются `ephemeral` и исключаются из LLM-контекста;
@@ -68,7 +78,8 @@ export type CommandResolveStatus = 'builtin' | 'prompt' | 'template' | 'skill' |
68
78
  * ответа нет и CLI не короткозамыкает;
69
79
  * - `template`/`skill`/`bundle` — текст в `prompt` уходит в LLM как явный
70
80
  * пользовательский контекст;
71
- * - `summarization` — триггер ручной суммаризации (`/summary`);
81
+ * - `summarization` — триггер ручного сжатия контекста (`/summary` —
82
+ * суммаризация, `/compact` — компактизация; профиль — в `compressionMode`);
72
83
  * - `unknown`/`denied`/`unavailable` — ответ-объяснение, LLM не вызывается.
73
84
  */
74
85
  export interface CommandResolveResult {
@@ -84,16 +95,23 @@ export interface CommandResolveResult {
84
95
  output?: string;
85
96
  /** Загруженные тела скиллов (для событий `skill.invoked`). */
86
97
  skills?: string[];
98
+ /**
99
+ * ADR-119: профиль сжатия для ручного запуска (`status: 'summarization'`).
100
+ *
101
+ * `/summary` — `summarization`, `/compact` — `compaction` (ADR-126 §1).
102
+ * Поле аддитивное: не задано — режим определяет эффективный режим сессии.
103
+ */
104
+ compressionMode?: CommandCompressionMode;
87
105
  /** Причина denied/unavailable. */
88
106
  message?: string;
89
107
  }
90
- /** ADR-046 §7.4: результат исполнения inline shell (`` !`cmd` ``). */
108
+ /** ADR-126 §15: результат исполнения inline shell (`` !`cmd` ``). */
91
109
  export interface CommandShellResult {
92
110
  output: string;
93
111
  isError: boolean;
94
112
  }
95
113
  /**
96
- * ADR-046 §7.4: раннер inline shell. Оркестратор передаёт замыкание, которое
114
+ * ADR-126 §15: раннер inline shell. Оркестратор передаёт замыкание, которое
97
115
  * само проходит `PermissionEvaluator` (ADR-029) и исполняет команду; сервис
98
116
  * команд только вызывает его для подстановки `` !`cmd` ``.
99
117
  */
@@ -109,11 +127,11 @@ export interface CommandRuntimeOpts {
109
127
  sessionEnabled?: string[];
110
128
  sessionDisabled?: string[];
111
129
  permissionConfig?: PermissionConfig;
112
- /** ADR-046 §7.4: раннер inline shell (только при включённом `skills.inlineShell`). */
130
+ /** ADR-126 §15: раннер inline shell (только при включённом `skills.inlineShell`). */
113
131
  runShell?: CommandShellRunner;
114
132
  }
115
133
  /**
116
- * ADR-046 §7.3: рантайм-контракт команд для оркестратора/CLI. Структурно
134
+ * ADR-126 §14: рантайм-контракт команд для оркестратора/CLI. Структурно
117
135
  * реализуется `CommandService`; прокидывается в `OrchestratorOptions`.
118
136
  */
119
137
  export interface CommandRuntime {
@@ -1,8 +1,8 @@
1
1
  /**
2
- * ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
2
+ * ADR-126 §1: slash-команды и bundles — контракты. Здесь только типы (без
3
3
  * бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
4
4
  */
5
- /** Вид команды (ADR-046 §7.2). */
5
+ /** Вид команды (ADR-126 §1). */
6
6
  export const COMMAND_KINDS = ['builtin', 'template', 'skill', 'bundle'];
7
7
  /** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
8
8
  export const COMMAND_CONFLICT_MODES = ['bundle-wins', 'conservative', 'namespace'];
@@ -92,10 +92,25 @@ export interface EgressRequestLogEntry {
92
92
  projectId?: string;
93
93
  actor?: string;
94
94
  }
95
- /** Скоупы изменений egress-политик/прокси в security-аудите. */
96
- export declare const SECURITY_AUDIT_SCOPES: readonly ["tools", "webhooks", "mcp", "proxy", "tls", "attachments", "context-window", "context-defaults", "sticky-notes", "agents", "limits", "permission", "ssh"];
95
+ /**
96
+ * Скоупы изменений egress-политик/прокси в security-аудите.
97
+ *
98
+ * `projects` (PROP-133 §3.1) — изменение состояния доступа к проекту
99
+ * (`members`/`group_members`/`everyone_role`).
100
+ * `timer` (PROP-141, Часть B) — создание/правка/снятие таймера и будильника
101
+ * и ошибка его срабатывания.
102
+ * `session` (PROP-141, Часть D) — перенос сессии между проектами (смена
103
+ * «дома» сессии с последствиями для её ресурсов).
104
+ * `background` — runtime-настройки секции `background` (реестр фоновых
105
+ * прогонов: мастер-выключатель, лимиты, предел лога, retention).
106
+ */
107
+ export declare const SECURITY_AUDIT_SCOPES: readonly ["tools", "webhooks", "mcp", "proxy", "tls", "attachments", "context-window", "context-defaults", "sticky-notes", "agents", "projects", "limits", "permission", "ssh", "timer", "session", "background"];
97
108
  export type SecurityAuditScope = (typeof SECURITY_AUDIT_SCOPES)[number];
98
- export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset", "grant", "revoke"];
109
+ /**
110
+ * Действия аудита. `move` (PROP-141, Часть D) — перенос сессии между
111
+ * проектами.
112
+ */
113
+ export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset", "grant", "revoke", "create", "remove", "fire", "move"];
99
114
  export type SecurityAuditAction = (typeof SECURITY_AUDIT_ACTIONS)[number];
100
115
  /**
101
116
  * Запись аудита изменений security-политик (append-only). `before`/`after` —
@@ -63,6 +63,21 @@ export const EGRESS_REQUEST_STATUSES = ['allowed', 'blocked', 'error'];
63
63
  * direct-фоллбек после недоступного прокси (`proxy.fallbackDirect`).
64
64
  */
65
65
  export const EGRESS_REQUEST_VIAS = ['proxy', 'direct', 'fallback'];
66
- /** Скоупы изменений egress-политик/прокси в security-аудите. */
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'];
66
+ /**
67
+ * Скоупы изменений egress-политик/прокси в security-аудите.
68
+ *
69
+ * `projects` (PROP-133 §3.1) — изменение состояния доступа к проекту
70
+ * (`members`/`group_members`/`everyone_role`).
71
+ * `timer` (PROP-141, Часть B) — создание/правка/снятие таймера и будильника
72
+ * и ошибка его срабатывания.
73
+ * `session` (PROP-141, Часть D) — перенос сессии между проектами (смена
74
+ * «дома» сессии с последствиями для её ресурсов).
75
+ * `background` — runtime-настройки секции `background` (реестр фоновых
76
+ * прогонов: мастер-выключатель, лимиты, предел лога, retention).
77
+ */
78
+ export const SECURITY_AUDIT_SCOPES = ['tools', 'webhooks', 'mcp', 'proxy', 'tls', 'attachments', 'context-window', 'context-defaults', 'sticky-notes', 'agents', 'projects', 'limits', 'permission', 'ssh', 'timer', 'session', 'background'];
79
+ /**
80
+ * Действия аудита. `move` (PROP-141, Часть D) — перенос сессии между
81
+ * проектами.
82
+ */
83
+ export const SECURITY_AUDIT_ACTIONS = ['update', 'reset', 'grant', 'revoke', 'create', 'remove', 'fire', 'move'];
@@ -6,7 +6,10 @@
6
6
  import type { SessionOrigin, SessionSettings } from './index.js';
7
7
  /**
8
8
  * Источник события. Свободная строка, известные значения: `'telegram'`,
9
- * `'synth-media'`, `'webhook'`, `'cron'`, `'ci'`, `'ui'`.
9
+ * `'synth-media'`, `'webhook'`, `'cron'`, `'ci'`, `'ui'`, `'timer'`.
10
+ *
11
+ * `'timer'` — срабатывание таймера/будильника (PROP-141, Часть B): источник
12
+ * добавляет движок `engine/timers`, тип события — `'timer_fired'`.
10
13
  */
11
14
  export type EventSource = string;
12
15
  /** Режим обработки события: `drop` — осознанный отказ с аудитом. */
@@ -78,7 +81,7 @@ export interface EventBinding {
78
81
  /** Конкретная постоянная сессия (mode=`bound`). */
79
82
  sessionId?: string;
80
83
  mode: EventDeliveryMode;
81
- /** Шаблон агента/скилла для создания/настройки сессии (ADR-046). */
84
+ /** Шаблон агента/скилла для создания/настройки сессии (ADR-126). */
82
85
  agentTemplate?: string;
83
86
  /** `projectId` — контейнер сессии (ADR-014). */
84
87
  project?: string;
@@ -203,6 +206,24 @@ export interface RouteDecisionMeta {
203
206
  type RouteDecisionKind = {
204
207
  kind: 'bound';
205
208
  sessionId: string;
209
+ /**
210
+ * PROP-141 (Часть B, «Доставка»): режим доставки в существующую сессию.
211
+ *
212
+ * `'steer'` — вклинивание в текущий ход (как завершение фонового
213
+ * процесса, ADR-113/ADR-104): ход идёт — инъекция на границе шага, хода
214
+ * нет — обычная очередь, фоллбек — запись в историю. Поле **аддитивное**
215
+ * и осмысленно только для `bound`: у остальных вариантов режим доставки
216
+ * задаёт сам Router/funnel, поведение источников не меняется.
217
+ *
218
+ * Не задано (или `'run'`) — прежнее поведение: сообщение ставится в
219
+ * очередь владельца с автозапуском обработки.
220
+ */
221
+ delivery?: 'steer';
222
+ /**
223
+ * Диагностическая метка правила, породившего решение (напр. `'timer'`).
224
+ * Аддитивная: у решений, порождённых не правилом, поля нет.
225
+ */
226
+ reason?: string;
206
227
  } | {
207
228
  kind: 'ephemeral';
208
229
  agentTemplate: string;