@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
@@ -22,8 +22,8 @@ export declare const projectIconKeySchema: z.ZodEnum<{
22
22
  image: "image";
23
23
  task: "task";
24
24
  todo: "todo";
25
- code: "code";
26
25
  terminal: "terminal";
26
+ code: "code";
27
27
  rocket: "rocket";
28
28
  flask: "flask";
29
29
  gamepad: "gamepad";
@@ -72,6 +72,41 @@ export declare const projectColorKeySchema: z.ZodEnum<{
72
72
  a15: "a15";
73
73
  a16: "a16";
74
74
  }>;
75
+ /**
76
+ * PROP-133: роль доступа к проекту (входной контракт записи состояния
77
+ * доступа). Неизвестная роль → `400 VALIDATION_ERROR` (fail-closed).
78
+ */
79
+ export declare const projectAccessRoleSchema: z.ZodEnum<{
80
+ viewer: "viewer";
81
+ editor: "editor";
82
+ owner: "owner";
83
+ }>;
84
+ /**
85
+ * PROP-133 §3.1: роль режима «всем пользователям» (`everyone_role`).
86
+ *
87
+ * Только `viewer`/`editor`: роль `owner` всем пользователям не выдаётся
88
+ * (эскалация прав) — роут режет такое значение `400 VALIDATION_ERROR`,
89
+ * значит и схема его не принимает (контракт схемы и роута совпадает).
90
+ */
91
+ export declare const projectEveryoneRoleSchema: z.ZodEnum<{
92
+ viewer: "viewer";
93
+ editor: "editor";
94
+ }>;
95
+ /**
96
+ * PROP-133: производное состояние видимости проекта — **только чтение/DTO**
97
+ * (во входные схемы не входит: значение выводится из состояния списка доступа).
98
+ */
99
+ export declare const projectVisibilitySchema: z.ZodEnum<{
100
+ author: "author";
101
+ selected: "selected";
102
+ all: "all";
103
+ }>;
104
+ /** PROP-133: карта грантов (субъект → роль). */
105
+ export declare const projectMembersSchema: z.ZodRecord<z.ZodString, z.ZodEnum<{
106
+ viewer: "viewer";
107
+ editor: "editor";
108
+ owner: "owner";
109
+ }>>;
75
110
  /** true, если значение — канонический ключ иконки (для записи и чтения). */
76
111
  export declare function isProjectIconKey(value: unknown): value is ProjectIconKey;
77
112
  /** true, если значение — канонический ключ цвета (без алиасов; для записи и чтения). */
@@ -89,6 +124,9 @@ export declare function normalizeColorKey(value: unknown): ProjectColorKey | und
89
124
  /**
90
125
  * ADR-106 Ф4: нормализация роли участника сессии. Каноническая роль → как
91
126
  * есть; всё прочее — **fail-closed** (`viewer`, только чтение).
127
+ *
128
+ * Канонический нормализатор — `normalizeProjectAccessRole` (PROP-133 §1): один
129
+ * источник истины для ролей проекта и участников сессии.
92
130
  */
93
131
  export declare function normalizeSessionParticipantRole(value: unknown): SessionParticipantRole;
94
132
  export declare const tokenUsageSchema: z.ZodObject<{
@@ -180,6 +218,8 @@ export declare const sessionSettingsSchema: z.ZodObject<{
180
218
  debugEnabled: z.ZodDefault<z.ZodBoolean>;
181
219
  streamEnabled: z.ZodDefault<z.ZodBoolean>;
182
220
  agentRole: z.ZodOptional<z.ZodString>;
221
+ executorProfile: z.ZodOptional<z.ZodString>;
222
+ browserProfile: z.ZodOptional<z.ZodString>;
183
223
  mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
184
224
  mcpDisabledServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
185
225
  contextOptimization: z.ZodDefault<z.ZodEnum<{
@@ -229,8 +269,8 @@ export declare const sessionCreateSchema: z.ZodObject<{
229
269
  image: "image";
230
270
  task: "task";
231
271
  todo: "todo";
232
- code: "code";
233
272
  terminal: "terminal";
273
+ code: "code";
234
274
  rocket: "rocket";
235
275
  flask: "flask";
236
276
  gamepad: "gamepad";
@@ -303,6 +343,8 @@ export declare const sessionCreateSchema: z.ZodObject<{
303
343
  debugEnabled: z.ZodDefault<z.ZodBoolean>;
304
344
  streamEnabled: z.ZodDefault<z.ZodBoolean>;
305
345
  agentRole: z.ZodOptional<z.ZodString>;
346
+ executorProfile: z.ZodOptional<z.ZodString>;
347
+ browserProfile: z.ZodOptional<z.ZodString>;
306
348
  mcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
307
349
  mcpDisabledServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
308
350
  contextOptimization: z.ZodDefault<z.ZodEnum<{
@@ -352,8 +394,8 @@ export declare const sessionUpdateSchema: z.ZodObject<{
352
394
  image: "image";
353
395
  task: "task";
354
396
  todo: "todo";
355
- code: "code";
356
397
  terminal: "terminal";
398
+ code: "code";
357
399
  rocket: "rocket";
358
400
  flask: "flask";
359
401
  gamepad: "gamepad";
@@ -426,6 +468,8 @@ export declare const sessionUpdateSchema: z.ZodObject<{
426
468
  debugEnabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
427
469
  streamEnabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
428
470
  agentRole: z.ZodOptional<z.ZodOptional<z.ZodString>>;
471
+ executorProfile: z.ZodOptional<z.ZodOptional<z.ZodString>>;
472
+ browserProfile: z.ZodOptional<z.ZodOptional<z.ZodString>>;
429
473
  mcpServers: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
430
474
  mcpDisabledServers: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
431
475
  contextOptimization: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
@@ -500,8 +544,8 @@ export declare const projectCreateSchema: z.ZodObject<{
500
544
  image: "image";
501
545
  task: "task";
502
546
  todo: "todo";
503
- code: "code";
504
547
  terminal: "terminal";
548
+ code: "code";
505
549
  rocket: "rocket";
506
550
  flask: "flask";
507
551
  gamepad: "gamepad";
@@ -564,11 +608,39 @@ export declare const projectCreateSchema: z.ZodObject<{
564
608
  sshKeyId: z.ZodOptional<z.ZodString>;
565
609
  lastFetch: z.ZodOptional<z.ZodString>;
566
610
  }, z.core.$strip>]>>>;
611
+ members: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
612
+ viewer: "viewer";
613
+ editor: "editor";
614
+ owner: "owner";
615
+ }>>>;
616
+ group_members: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
617
+ viewer: "viewer";
618
+ editor: "editor";
619
+ owner: "owner";
620
+ }>>>;
621
+ everyone_role: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
622
+ viewer: "viewer";
623
+ editor: "editor";
624
+ }>, z.ZodNull]>>;
567
625
  }, z.core.$strip>;
568
626
  /** ADR-107: проектная политика памяти (undefined — не менять). */
569
627
  export declare const projectMemoryUpdateSchema: z.ZodObject<{
570
628
  enabled: z.ZodOptional<z.ZodBoolean>;
571
629
  }, z.core.$strip>;
630
+ /**
631
+ * PROP-135 Ф6a: профиль исполнения проекта (`PUT /api/v2/projects/:id`).
632
+ *
633
+ * `profile`/`allowedProfiles` — `null`/`''` сбрасывают значение (потолок не
634
+ * задан), `[]` — «профилей нет» (ADR-135, аддендум: пустой список = ничего не
635
+ * разрешено). Существование профиля в `execution.remote.profiles` и его
636
+ * вхождение в список разрешённых проверяет роут (если каталог ему доступен).
637
+ */
638
+ export declare const projectExecutorUpdateSchema: z.ZodObject<{
639
+ profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
640
+ allowedProfiles: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
641
+ browserProfile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
642
+ allowedBrowserProfiles: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
643
+ }, z.core.$strip>;
572
644
  export declare const projectUpdateSchema: z.ZodObject<{
573
645
  name: z.ZodOptional<z.ZodString>;
574
646
  description: z.ZodOptional<z.ZodString>;
@@ -581,8 +653,8 @@ export declare const projectUpdateSchema: z.ZodObject<{
581
653
  image: "image";
582
654
  task: "task";
583
655
  todo: "todo";
584
- code: "code";
585
656
  terminal: "terminal";
657
+ code: "code";
586
658
  rocket: "rocket";
587
659
  flask: "flask";
588
660
  gamepad: "gamepad";
@@ -648,7 +720,38 @@ export declare const projectUpdateSchema: z.ZodObject<{
648
720
  memory: z.ZodOptional<z.ZodObject<{
649
721
  enabled: z.ZodOptional<z.ZodBoolean>;
650
722
  }, z.core.$strip>>;
723
+ executor: z.ZodOptional<z.ZodObject<{
724
+ profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
725
+ allowedProfiles: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
726
+ browserProfile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
727
+ allowedBrowserProfiles: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
728
+ }, z.core.$strip>>;
729
+ members: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
730
+ viewer: "viewer";
731
+ editor: "editor";
732
+ owner: "owner";
733
+ }>>>;
734
+ group_members: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
735
+ viewer: "viewer";
736
+ editor: "editor";
737
+ owner: "owner";
738
+ }>>>;
739
+ everyone_role: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
740
+ viewer: "viewer";
741
+ editor: "editor";
742
+ }>, z.ZodNull]>>;
651
743
  }, z.core.$strip>;
744
+ /**
745
+ * ADR-140 Ф3: тело передачи владения проектом
746
+ * (`POST /api/v2/projects/:id/transfer`).
747
+ *
748
+ * `user_id` — id нового владельца (обязателен, непустая строка). Тело
749
+ * **strict**: лишнее поле — ошибка валидации, а не молчаливое игнорирование
750
+ * (опечатка в теле иначе «передала бы владение не туда»).
751
+ */
752
+ export declare const projectTransferSchema: z.ZodObject<{
753
+ user_id: z.ZodString;
754
+ }, z.core.$strict>;
652
755
  /**
653
756
  * ADR-076: тело создания SSH-ключа (`POST /api/v2/ssh-keys`).
654
757
  *
@@ -824,6 +927,25 @@ export declare const gitCommitQuerySchema: z.ZodObject<{
824
927
  repo_path: z.ZodDefault<z.ZodString>;
825
928
  hash: z.ZodString;
826
929
  }, z.core.$strip>;
930
+ /** ADR-076 (этап 1): `GET /git/status` — состояние рабочего дерева репозитория(ев). */
931
+ export declare const gitStatusQuerySchema: z.ZodObject<{
932
+ project_id: z.ZodString;
933
+ repo_path: z.ZodDefault<z.ZodString>;
934
+ }, z.core.$strip>;
935
+ /**
936
+ * ADR-076 (этап 1): `GET /git/diff` — diff рабочего дерева.
937
+ *
938
+ * `staged` принимает строковые `true`/`false` (query-параметры): `z.coerce.boolean()`
939
+ * не подходит — `'false'` превратился бы в `true` (та же ловушка, что у
940
+ * `fsWorkspaceBrowseQuerySchema`).
941
+ */
942
+ export declare const gitDiffQuerySchema: z.ZodObject<{
943
+ project_id: z.ZodString;
944
+ repo_path: z.ZodDefault<z.ZodString>;
945
+ path: z.ZodOptional<z.ZodString>;
946
+ staged: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean, unknown>>;
947
+ context: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
948
+ }, z.core.$strip>;
827
949
  /**
828
950
  * ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
829
951
  * на базе `ToolCapability`).
@@ -902,11 +1024,13 @@ export type GitReposRemoveBody = z.infer<typeof gitReposRemoveBodySchema>;
902
1024
  export type GitReposFetchBody = z.infer<typeof gitReposFetchBodySchema>;
903
1025
  export type GitLogQuery = z.infer<typeof gitLogQuerySchema>;
904
1026
  export type GitCommitQuery = z.infer<typeof gitCommitQuerySchema>;
905
- /** ADR-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
1027
+ export type GitStatusQuery = z.infer<typeof gitStatusQuerySchema>;
1028
+ export type GitDiffQuery = z.infer<typeof gitDiffQuerySchema>;
1029
+ /** ADR-126 §13: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
906
1030
  export declare const SKILL_NAME_REGEX: RegExp;
907
1031
  export declare const SKILL_NAME_MIN = 1;
908
1032
  export declare const SKILL_NAME_MAX = 64;
909
- /** ADR-046 §3.2: длина `description`. */
1033
+ /** ADR-126 §13: длина `description`. */
910
1034
  export declare const SKILL_DESCRIPTION_MIN = 1;
911
1035
  export declare const SKILL_DESCRIPTION_MAX = 1024;
912
1036
  export declare const skillNameSchema: z.ZodString;
@@ -925,7 +1049,7 @@ export declare const skillFileWriteSchema: z.ZodObject<{
925
1049
  content: z.ZodString;
926
1050
  }, z.core.$strip>;
927
1051
  /**
928
- * ADR-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
1052
+ * ADR-126 §11: per-session enable/disable скиллов (по образцу MCP-скоупа).
929
1053
  * `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
930
1054
  */
931
1055
  export declare const skillSessionOverrideSchema: z.ZodObject<{
@@ -936,7 +1060,7 @@ export type SkillCreateRequest = z.infer<typeof skillCreateSchema>;
936
1060
  export type SkillUpdateRequest = z.infer<typeof skillUpdateSchema>;
937
1061
  export type SkillFileWriteRequest = z.infer<typeof skillFileWriteSchema>;
938
1062
  export type SkillSessionOverrideRequest = z.infer<typeof skillSessionOverrideSchema>;
939
- /** ADR-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
1063
+ /** ADR-126 §14: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
940
1064
  export declare const skillBundleSchema: z.ZodObject<{
941
1065
  name: z.ZodString;
942
1066
  description: z.ZodString;
@@ -944,7 +1068,7 @@ export declare const skillBundleSchema: z.ZodObject<{
944
1068
  instruction: z.ZodOptional<z.ZodString>;
945
1069
  }, z.core.$strip>;
946
1070
  export type SkillBundleRequest = z.infer<typeof skillBundleSchema>;
947
- /** ADR-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
1071
+ /** ADR-126 §15: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
948
1072
  export declare const skillsDisabledSchema: z.ZodObject<{
949
1073
  categories: z.ZodDefault<z.ZodArray<z.ZodString>>;
950
1074
  groups: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -952,7 +1076,7 @@ export declare const skillsDisabledSchema: z.ZodObject<{
952
1076
  }, z.core.$strip>;
953
1077
  export type SkillsDisabledRequest = z.infer<typeof skillsDisabledSchema>;
954
1078
  /**
955
- * ADR-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
1079
+ * ADR-126 §11: тело `PUT /api/v2/settings/skills` — системные настройки:
956
1080
  * - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
957
1081
  * - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
958
1082
  * - `policy` — политика доступности (строкой, валидируется роутом).
@@ -972,7 +1096,7 @@ export declare const skillsSystemSettingsSchema: z.ZodObject<{
972
1096
  }, z.core.$strip>;
973
1097
  export type SkillsSystemSettingsRequest = z.infer<typeof skillsSystemSettingsSchema>;
974
1098
  /**
975
- * ADR-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
1099
+ * ADR-126 §11: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
976
1100
  * (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
977
1101
  */
978
1102
  export declare const sessionSkillUpdateSchema: z.ZodObject<{
@@ -981,7 +1105,7 @@ export declare const sessionSkillUpdateSchema: z.ZodObject<{
981
1105
  skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
982
1106
  skillsDisabled: z.ZodOptional<z.ZodArray<z.ZodString>>;
983
1107
  }, z.core.$strip>;
984
- /** ADR-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
1108
+ /** ADR-126 §11: тело `PUT /api/v2/projects/:id/skills`. */
985
1109
  export declare const projectSkillUpdateSchema: z.ZodObject<{
986
1110
  enabled: z.ZodOptional<z.ZodArray<z.ZodString>>;
987
1111
  defaultOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1049,10 +1173,10 @@ export declare const eventBindingSchema: z.ZodObject<{
1049
1173
  /** ADR-089: схема запроса создания/привязки сессии — единый funnel. */
1050
1174
  export declare const sessionRequestSchema: z.ZodObject<{
1051
1175
  initiator: z.ZodEnum<{
1176
+ external: "external";
1052
1177
  system: "system";
1053
1178
  user: "user";
1054
1179
  agent: "agent";
1055
- external: "external";
1056
1180
  }>;
1057
1181
  intent: z.ZodEnum<{
1058
1182
  event: "event";
@@ -1075,8 +1199,8 @@ export declare const sessionRequestSchema: z.ZodObject<{
1075
1199
  image: "image";
1076
1200
  task: "task";
1077
1201
  todo: "todo";
1078
- code: "code";
1079
1202
  terminal: "terminal";
1203
+ code: "code";
1080
1204
  rocket: "rocket";
1081
1205
  flask: "flask";
1082
1206
  gamepad: "gamepad";
@@ -1408,7 +1532,7 @@ export declare const scheduleTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
1408
1532
  }, z.core.$strip>, z.ZodObject<{
1409
1533
  mode: z.ZodLiteral<"ephemeral">;
1410
1534
  agentTemplate: z.ZodOptional<z.ZodString>;
1411
- project: z.ZodOptional<z.ZodString>;
1535
+ project: z.ZodString;
1412
1536
  ttl: z.ZodOptional<z.ZodString>;
1413
1537
  }, z.core.$strip>, z.ZodObject<{
1414
1538
  mode: z.ZodLiteral<"queue">;
@@ -1601,6 +1725,7 @@ export type EventRouteRuleUpsertRequest = z.infer<typeof eventRouteRuleUpsertSch
1601
1725
  export declare const scheduleInputSchema: z.ZodObject<{
1602
1726
  name: z.ZodString;
1603
1727
  enabled: z.ZodDefault<z.ZodBoolean>;
1728
+ projectId: z.ZodOptional<z.ZodString>;
1604
1729
  cron: z.ZodOptional<z.ZodString>;
1605
1730
  every: z.ZodOptional<z.ZodString>;
1606
1731
  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1609,7 +1734,7 @@ export declare const scheduleInputSchema: z.ZodObject<{
1609
1734
  }, z.core.$strip>, z.ZodObject<{
1610
1735
  mode: z.ZodLiteral<"ephemeral">;
1611
1736
  agentTemplate: z.ZodOptional<z.ZodString>;
1612
- project: z.ZodOptional<z.ZodString>;
1737
+ project: z.ZodString;
1613
1738
  ttl: z.ZodOptional<z.ZodString>;
1614
1739
  }, z.core.$strip>, z.ZodObject<{
1615
1740
  mode: z.ZodLiteral<"queue">;
@@ -1634,6 +1759,7 @@ export declare const scheduleSchema: z.ZodObject<{
1634
1759
  id: z.ZodString;
1635
1760
  name: z.ZodString;
1636
1761
  enabled: z.ZodBoolean;
1762
+ projectId: z.ZodString;
1637
1763
  cron: z.ZodOptional<z.ZodString>;
1638
1764
  every: z.ZodOptional<z.ZodString>;
1639
1765
  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1642,7 +1768,7 @@ export declare const scheduleSchema: z.ZodObject<{
1642
1768
  }, z.core.$strip>, z.ZodObject<{
1643
1769
  mode: z.ZodLiteral<"ephemeral">;
1644
1770
  agentTemplate: z.ZodOptional<z.ZodString>;
1645
- project: z.ZodOptional<z.ZodString>;
1771
+ project: z.ZodString;
1646
1772
  ttl: z.ZodOptional<z.ZodString>;
1647
1773
  }, z.core.$strip>, z.ZodObject<{
1648
1774
  mode: z.ZodLiteral<"queue">;
@@ -1704,7 +1830,7 @@ export declare const scheduleJobSchema: z.ZodObject<{
1704
1830
  }, z.core.$strip>, z.ZodObject<{
1705
1831
  mode: z.ZodLiteral<"ephemeral">;
1706
1832
  agentTemplate: z.ZodOptional<z.ZodString>;
1707
- project: z.ZodOptional<z.ZodString>;
1833
+ project: z.ZodString;
1708
1834
  ttl: z.ZodOptional<z.ZodString>;
1709
1835
  }, z.core.$strip>, z.ZodObject<{
1710
1836
  mode: z.ZodLiteral<"queue">;
@@ -2105,6 +2231,17 @@ export type TodoCreateRequest = z.infer<typeof todoCreateSchema>;
2105
2231
  export type TodoUpdateRequest = z.infer<typeof todoUpdateSchema>;
2106
2232
  export type TodoOrderRequest = z.infer<typeof todoOrderSchema>;
2107
2233
  export type TodoClearRequest = z.infer<typeof todoClearSchema>;
2234
+ /**
2235
+ * Тело `POST /sessions/:id/scripts/:name/run`: только аргументы скрипта.
2236
+ *
2237
+ * Аргументы приходят **строкой** — их разбирает лексер скриптов
2238
+ * (`engine/scripts/args.ts`), без shell. Строгая схема: неизвестные поля →
2239
+ * 400 `VALIDATION_ERROR`.
2240
+ */
2241
+ export declare const scriptRunRequestSchema: z.ZodObject<{
2242
+ arguments: z.ZodOptional<z.ZodString>;
2243
+ }, z.core.$strict>;
2244
+ export type ScriptRunRequest = z.infer<typeof scriptRunRequestSchema>;
2108
2245
  /** Новая запись журнала проекта (Markdown, лимит `MARKDOWN_LIMITS.journalEntry`). */
2109
2246
  export declare const projectLogCreateSchema: z.ZodObject<{
2110
2247
  text: z.ZodString;
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, STEER_MODES, DEFAULT_STEER_MODE, EFFORT_LEVELS, SSH_KEY_USAGES, MAX_SSH_ALLOW_HOSTS, MAX_SSH_ALLOW_PORTS, isValidHostRule, HOST_RULE_FORMAT_HINT, MARKDOWN_LIMITS, TODO_STATUSES, TODO_PRIORITIES, } from '../types/index.js';
3
+ import { normalizeProjectAccessRole } from '../types/project-access.js';
3
4
  import { ToolCapability } from '../types/tools.js';
4
5
  /**
5
6
  * Экземпляр zod, которым построены **все** схемы этого пакета.
@@ -17,6 +18,26 @@ export const statusMessageTypeSchema = z.nativeEnum(StatusMessageType);
17
18
  /** Zod-схемы канонических ключей иконок/цветов (единые для project и session). */
18
19
  export const projectIconKeySchema = z.enum(PROJECT_ICON_KEYS);
19
20
  export const projectColorKeySchema = z.enum(PROJECT_COLOR_KEYS);
21
+ /**
22
+ * PROP-133: роль доступа к проекту (входной контракт записи состояния
23
+ * доступа). Неизвестная роль → `400 VALIDATION_ERROR` (fail-closed).
24
+ */
25
+ export const projectAccessRoleSchema = z.enum(['owner', 'editor', 'viewer']);
26
+ /**
27
+ * PROP-133 §3.1: роль режима «всем пользователям» (`everyone_role`).
28
+ *
29
+ * Только `viewer`/`editor`: роль `owner` всем пользователям не выдаётся
30
+ * (эскалация прав) — роут режет такое значение `400 VALIDATION_ERROR`,
31
+ * значит и схема его не принимает (контракт схемы и роута совпадает).
32
+ */
33
+ export const projectEveryoneRoleSchema = z.enum(['viewer', 'editor']);
34
+ /**
35
+ * PROP-133: производное состояние видимости проекта — **только чтение/DTO**
36
+ * (во входные схемы не входит: значение выводится из состояния списка доступа).
37
+ */
38
+ export const projectVisibilitySchema = z.enum(['author', 'selected', 'all']);
39
+ /** PROP-133: карта грантов (субъект → роль). */
40
+ export const projectMembersSchema = z.record(z.string().min(1), projectAccessRoleSchema);
20
41
  /** true, если значение — канонический ключ иконки (для записи и чтения). */
21
42
  export function isProjectIconKey(value) {
22
43
  return typeof value === 'string' && PROJECT_ICON_KEYS.includes(value);
@@ -42,11 +63,12 @@ export function normalizeColorKey(value) {
42
63
  /**
43
64
  * ADR-106 Ф4: нормализация роли участника сессии. Каноническая роль → как
44
65
  * есть; всё прочее — **fail-closed** (`viewer`, только чтение).
66
+ *
67
+ * Канонический нормализатор — `normalizeProjectAccessRole` (PROP-133 §1): один
68
+ * источник истины для ролей проекта и участников сессии.
45
69
  */
46
70
  export function normalizeSessionParticipantRole(value) {
47
- if (value === 'owner' || value === 'editor' || value === 'viewer')
48
- return value;
49
- return 'viewer';
71
+ return normalizeProjectAccessRole(value);
50
72
  }
51
73
  export const tokenUsageSchema = z.object({
52
74
  inputTokens: z.number().int().min(0),
@@ -142,6 +164,17 @@ export const sessionSettingsSchema = z.object({
142
164
  debugEnabled: z.boolean().default(true),
143
165
  streamEnabled: z.boolean().default(true),
144
166
  agentRole: z.string().optional(),
167
+ /**
168
+ * PROP-135 Ф4a: имя профиля исполнения сессии (`execution.remote.profiles`).
169
+ * Порт тулов сессии выбирает роутер по этому имени; не задан — профиль по
170
+ * умолчанию (`execution.remote.defaultProfile`).
171
+ */
172
+ executorProfile: z.string().optional(),
173
+ /**
174
+ * PROP-135 (браузерный контур): профиль браузерного пула сессии. Пустая
175
+ * строка — явный сброс (наследование агент→проект→инстанс).
176
+ */
177
+ browserProfile: z.string().optional(),
145
178
  // ADR-071 §2.4: сессионный скоуп MCP (явно включённые / opt-out).
146
179
  mcpServers: z.array(z.string()).optional(),
147
180
  mcpDisabledServers: z.array(z.string()).optional(),
@@ -165,7 +198,7 @@ export const sessionSettingsSchema = z.object({
165
198
  language: z.string().optional(),
166
199
  // === Plan/Act (ADR-025) ===
167
200
  planMode: z.enum(['auto', 'strict', 'off']).optional(),
168
- // === Скиллы (ADR-046 §4.5) ===
201
+ // === Скиллы (ADR-126 §11) ===
169
202
  skills: z.array(z.string()).optional(),
170
203
  skillsDisabled: z.array(z.string()).optional(),
171
204
  // === Микро-слой (ADR-035/ADR-084) ===
@@ -229,9 +262,30 @@ export const projectCreateSchema = z.object({
229
262
  color: projectColorKeySchema.optional().nullable(),
230
263
  workspace: z.string().optional(),
231
264
  repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
265
+ // PROP-133 §3.1: состояние списка доступа. `everyone_role: null` — проект
266
+ // не опубликован; `visibility` во вход не принимается (производная величина).
267
+ members: projectMembersSchema.optional(),
268
+ group_members: projectMembersSchema.optional(),
269
+ everyone_role: z.union([projectEveryoneRoleSchema, z.null()]).optional(),
232
270
  });
233
271
  /** ADR-107: проектная политика памяти (undefined — не менять). */
234
272
  export const projectMemoryUpdateSchema = z.object({ enabled: z.boolean().optional() });
273
+ /**
274
+ * PROP-135 Ф6a: профиль исполнения проекта (`PUT /api/v2/projects/:id`).
275
+ *
276
+ * `profile`/`allowedProfiles` — `null`/`''` сбрасывают значение (потолок не
277
+ * задан), `[]` — «профилей нет» (ADR-135, аддендум: пустой список = ничего не
278
+ * разрешено). Существование профиля в `execution.remote.profiles` и его
279
+ * вхождение в список разрешённых проверяет роут (если каталог ему доступен).
280
+ */
281
+ export const projectExecutorUpdateSchema = z.object({
282
+ profile: z.string().nullable().optional(),
283
+ allowedProfiles: z.array(z.string()).nullable().optional(),
284
+ /** PROP-135 (браузерный контур): профиль браузерного пула проекта. */
285
+ browserProfile: z.string().nullable().optional(),
286
+ /** PROP-135 (браузерный контур): потолок браузерных профилей проекта. */
287
+ allowedBrowserProfiles: z.array(z.string()).nullable().optional(),
288
+ });
235
289
  export const projectUpdateSchema = z.object({
236
290
  name: z.string().min(1).max(200).optional(),
237
291
  description: z.string().optional(),
@@ -242,7 +296,21 @@ export const projectUpdateSchema = z.object({
242
296
  workspace: z.string().optional(),
243
297
  repos: z.array(z.union([z.string(), gitRepoConfigSchema])).optional(),
244
298
  memory: projectMemoryUpdateSchema.optional(),
299
+ executor: projectExecutorUpdateSchema.optional(),
300
+ // PROP-133 §3.1: состояние списка доступа (см. `projectCreateSchema`).
301
+ members: projectMembersSchema.optional(),
302
+ group_members: projectMembersSchema.optional(),
303
+ everyone_role: z.union([projectEveryoneRoleSchema, z.null()]).optional(),
245
304
  });
305
+ /**
306
+ * ADR-140 Ф3: тело передачи владения проектом
307
+ * (`POST /api/v2/projects/:id/transfer`).
308
+ *
309
+ * `user_id` — id нового владельца (обязателен, непустая строка). Тело
310
+ * **strict**: лишнее поле — ошибка валидации, а не молчаливое игнорирование
311
+ * (опечатка в теле иначе «передала бы владение не туда»).
312
+ */
313
+ export const projectTransferSchema = z.object({ user_id: z.string().min(1) }).strict();
246
314
  /**
247
315
  * PROP-124: правило хоста в политике SSH-ключа.
248
316
  *
@@ -439,6 +507,27 @@ export const gitCommitQuerySchema = z.object({
439
507
  repo_path: z.string().default(''),
440
508
  hash: z.string().min(1),
441
509
  });
510
+ /** ADR-076 (этап 1): `GET /git/status` — состояние рабочего дерева репозитория(ев). */
511
+ export const gitStatusQuerySchema = z.object({
512
+ project_id: z.string().min(1),
513
+ repo_path: z.string().default(''),
514
+ });
515
+ /**
516
+ * ADR-076 (этап 1): `GET /git/diff` — diff рабочего дерева.
517
+ *
518
+ * `staged` принимает строковые `true`/`false` (query-параметры): `z.coerce.boolean()`
519
+ * не подходит — `'false'` превратился бы в `true` (та же ловушка, что у
520
+ * `fsWorkspaceBrowseQuerySchema`).
521
+ */
522
+ export const gitDiffQuerySchema = z.object({
523
+ project_id: z.string().min(1),
524
+ repo_path: z.string().default(''),
525
+ path: z.string().min(1).optional(),
526
+ staged: z
527
+ .preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean())
528
+ .default(false),
529
+ context: z.coerce.number().int().min(0).max(10).default(3),
530
+ });
442
531
  const toolCapabilityValues = Object.values(ToolCapability);
443
532
  /**
444
533
  * ADR-071 §2.6: фабрика схемы `tools.disabled` (единый источник значений
@@ -491,12 +580,12 @@ export const sessionMcpUpdateSchema = z
491
580
  .refine((v) => v.name !== undefined
492
581
  || v.mcpServers !== undefined
493
582
  || v.mcpDisabledServers !== undefined, { message: 'Требуется name, mcpServers или mcpDisabledServers' });
494
- // --- Скиллы (ADR-046) ---
495
- /** ADR-046 §3.2: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
583
+ // --- Скиллы (ADR-126) ---
584
+ /** ADR-126 §13: имя скилла — 1–64, `^[a-z0-9]+(-[a-z0-9]+)*$`. */
496
585
  export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
497
586
  export const SKILL_NAME_MIN = 1;
498
587
  export const SKILL_NAME_MAX = 64;
499
- /** ADR-046 §3.2: длина `description`. */
588
+ /** ADR-126 §13: длина `description`. */
500
589
  export const SKILL_DESCRIPTION_MIN = 1;
501
590
  export const SKILL_DESCRIPTION_MAX = 1024;
502
591
  export const skillNameSchema = z
@@ -524,29 +613,29 @@ export const skillFileWriteSchema = z.object({
524
613
  content: z.string(),
525
614
  });
526
615
  /**
527
- * ADR-046 §4.5: per-session enable/disable скиллов (по образцу MCP-скоупа).
616
+ * ADR-126 §11: per-session enable/disable скиллов (по образцу MCP-скоупа).
528
617
  * `undefined` ≠ `[]`: отсутствующее поле сохраняет текущее значение.
529
618
  */
530
619
  export const skillSessionOverrideSchema = z.object({
531
620
  skills: z.array(z.string()).optional(),
532
621
  skillsDisabled: z.array(z.string()).optional(),
533
622
  });
534
- // --- Slash-команды и bundles (ADR-046 §7) ---
535
- /** ADR-046 §7.3: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
623
+ // --- Slash-команды и bundles (ADR-126 §1) ---
624
+ /** ADR-126 §14: тело `POST/PATCH /api/v2/skill-bundles` (YAML-группа скиллов). */
536
625
  export const skillBundleSchema = z.object({
537
626
  name: skillNameSchema,
538
627
  description: z.string().min(SKILL_DESCRIPTION_MIN).max(SKILL_DESCRIPTION_MAX),
539
628
  skills: z.array(skillNameSchema).min(1),
540
629
  instruction: z.string().optional(),
541
630
  });
542
- /** ADR-046 §7.4: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
631
+ /** ADR-126 §15: тело `PUT /api/v2/settings/skills-disabled` (группы/имена). */
543
632
  export const skillsDisabledSchema = z.object({
544
633
  categories: z.array(z.string()).default([]),
545
634
  groups: z.array(z.string()).default([]),
546
635
  skills: z.array(z.string()).default([]),
547
636
  });
548
637
  /**
549
- * ADR-046 §4.5: тело `PUT /api/v2/settings/skills` — системные настройки:
638
+ * ADR-126 §11: тело `PUT /api/v2/settings/skills` — системные настройки:
550
639
  * - `disabled` — hard-gate: скиллы, недоступные НИГДЕ;
551
640
  * - `disabledForNewProjects` — сид для НОВЫХ проектов (снимок при создании);
552
641
  * - `policy` — политика доступности (строкой, валидируется роутом).
@@ -557,7 +646,7 @@ export const skillsSystemSettingsSchema = z.object({
557
646
  policy: z.string().optional(),
558
647
  });
559
648
  /**
560
- * ADR-046 §4.5: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
649
+ * ADR-126 §11: тело `PUT /api/v2/sessions/:id/skills`: точечный toggle
561
650
  * (`{ name, enabled }`) или полная/частичная замена (`{ skills?, skillsDisabled? }`).
562
651
  */
563
652
  export const sessionSkillUpdateSchema = z
@@ -570,7 +659,7 @@ export const sessionSkillUpdateSchema = z
570
659
  .refine((v) => v.name !== undefined
571
660
  || v.skills !== undefined
572
661
  || v.skillsDisabled !== undefined, { message: 'Требуется name, skills или skillsDisabled' });
573
- /** ADR-046 §4.5: тело `PUT /api/v2/projects/:id/skills`. */
662
+ /** ADR-126 §11: тело `PUT /api/v2/projects/:id/skills`. */
574
663
  export const projectSkillUpdateSchema = z.object({
575
664
  enabled: z.array(z.string()).optional(),
576
665
  defaultOn: z.array(z.string()).optional(),
@@ -863,7 +952,9 @@ export const scheduleTargetSchema = z.discriminatedUnion('mode', [
863
952
  z.object({
864
953
  mode: z.literal('ephemeral'),
865
954
  agentTemplate: z.string().optional(),
866
- project: z.string().optional(),
955
+ // PROP-141: проект у ephemeral-цели обязателен — инстансных
956
+ // автоматизаций нет (каждая автоматизация принадлежит проекту).
957
+ project: z.string().min(1),
867
958
  ttl: z.string().optional(),
868
959
  }),
869
960
  z.object({ mode: z.literal('queue'), sessionId: z.string().min(1) }),
@@ -966,6 +1057,10 @@ export const scheduleInputSchema = z
966
1057
  .object({
967
1058
  name: z.string().min(1),
968
1059
  enabled: z.boolean().default(true),
1060
+ // PROP-141: проект расписания. В теле необязателен — сервер выводит его
1061
+ // из цели расписания (и сверяет с переданным); в самой записи
1062
+ // (`scheduleSchema`) поле обязательно.
1063
+ projectId: z.string().min(1).optional(),
969
1064
  cron: z.string().optional(),
970
1065
  every: z.string().optional(),
971
1066
  target: scheduleTargetSchema,
@@ -981,6 +1076,9 @@ export const scheduleSchema = z
981
1076
  id: z.string().min(1),
982
1077
  name: z.string().min(1),
983
1078
  enabled: z.boolean(),
1079
+ // PROP-141: проект расписания обязателен (пустая строка — «проект не
1080
+ // определён», легаси-запись без проекта: отключена, `project_required`).
1081
+ projectId: z.string(),
984
1082
  cron: z.string().optional(),
985
1083
  every: z.string().optional(),
986
1084
  target: scheduleTargetSchema,
@@ -1258,6 +1356,19 @@ export const todoClearSchema = z
1258
1356
  statuses: z.array(z.enum(TODO_STATUSES)).optional(),
1259
1357
  })
1260
1358
  .strict();
1359
+ // --- Тело запуска скрипта проекта (ADR-126 §5) — strict ---
1360
+ /**
1361
+ * Тело `POST /sessions/:id/scripts/:name/run`: только аргументы скрипта.
1362
+ *
1363
+ * Аргументы приходят **строкой** — их разбирает лексер скриптов
1364
+ * (`engine/scripts/args.ts`), без shell. Строгая схема: неизвестные поля →
1365
+ * 400 `VALIDATION_ERROR`.
1366
+ */
1367
+ export const scriptRunRequestSchema = z
1368
+ .object({
1369
+ arguments: z.string().max(10_000).optional(),
1370
+ })
1371
+ .strict();
1261
1372
  // --- Тела HTTP-мутаций журнала и инвариантов (PROP-054) — strict ---
1262
1373
  /** Новая запись журнала проекта (Markdown, лимит `MARKDOWN_LIMITS.journalEntry`). */
1263
1374
  export const projectLogCreateSchema = z