@itphx/synth-shared 0.13.4 → 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.
- package/dist/config/defaults.js +102 -3
- package/dist/config/env-overrides.d.ts +39 -4
- package/dist/config/env-overrides.js +174 -4
- package/dist/config/execution-runtime.d.ts +89 -0
- package/dist/config/execution-runtime.js +506 -0
- package/dist/config/execution.d.ts +202 -1
- package/dist/config/execution.js +459 -3
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +8 -0
- package/dist/config/loader.js +6 -1
- package/dist/config/redact.d.ts +22 -0
- package/dist/config/redact.js +53 -0
- package/dist/config/security.d.ts +77 -0
- package/dist/config/security.js +116 -0
- package/dist/config/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +568 -38
- package/dist/config/types.js +390 -33
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +325 -13
- package/dist/index.d.ts +7 -6
- package/dist/index.js +17 -4
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +444 -30
- package/dist/schemas/index.js +354 -17
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +29 -1
- package/dist/types/authority.d.ts +10 -0
- package/dist/types/authority.js +8 -0
- package/dist/types/bus-events.d.ts +88 -2
- package/dist/types/catalog.d.ts +1 -1
- package/dist/types/catalog.js +1 -1
- package/dist/types/command-audit.d.ts +91 -0
- package/dist/types/command-audit.js +44 -0
- package/dist/types/commands.d.ts +29 -11
- package/dist/types/commands.js +2 -2
- package/dist/types/egress.d.ts +18 -3
- package/dist/types/egress.js +18 -3
- package/dist/types/events.d.ts +23 -2
- package/dist/types/execution.d.ts +424 -0
- package/dist/types/execution.js +355 -0
- package/dist/types/file-kind.d.ts +3 -2
- package/dist/types/file-kind.js +11 -2
- package/dist/types/git.d.ts +131 -0
- package/dist/types/git.js +101 -1
- package/dist/types/host-pattern.d.ts +41 -0
- package/dist/types/host-pattern.js +143 -0
- package/dist/types/index.d.ts +8 -0
- package/dist/types/index.js +25 -3
- package/dist/types/maintenance.d.ts +1 -1
- package/dist/types/mcp.d.ts +90 -0
- package/dist/types/mcp.js +11 -0
- package/dist/types/mentions.d.ts +96 -0
- package/dist/types/mentions.js +9 -0
- package/dist/types/message-stream.d.ts +41 -0
- package/dist/types/message.d.ts +24 -1
- package/dist/types/message.js +13 -0
- package/dist/types/pack.d.ts +21 -21
- package/dist/types/pack.js +4 -4
- package/dist/types/permission.d.ts +20 -3
- package/dist/types/pipeline.d.ts +2 -2
- package/dist/types/plugin-protocol.d.ts +203 -4
- package/dist/types/plugin-protocol.js +77 -4
- package/dist/types/project-access.d.ts +94 -0
- package/dist/types/project-access.js +140 -0
- package/dist/types/project.d.ts +89 -2
- package/dist/types/project.js +36 -0
- package/dist/types/prompt.d.ts +4 -2
- package/dist/types/schedules.d.ts +49 -3
- package/dist/types/schedules.js +50 -1
- package/dist/types/scripts.d.ts +98 -0
- package/dist/types/scripts.js +14 -0
- package/dist/types/service-keys.d.ts +16 -3
- package/dist/types/service-keys.js +19 -1
- package/dist/types/session.d.ts +68 -3
- package/dist/types/skills.d.ts +21 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/timers.d.ts +402 -0
- package/dist/types/timers.js +166 -0
- package/dist/types/tools.d.ts +160 -1
- package/dist/types/tools.js +70 -0
- package/dist/types/user.d.ts +24 -0
- package/dist/types/worktree.d.ts +1 -1
- package/dist/utils/index.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +3 -2
|
@@ -33,8 +33,39 @@
|
|
|
33
33
|
*/
|
|
34
34
|
import { isLlmFilterFailMode, isLlmFilterPhase } from './llm-filters.js';
|
|
35
35
|
import { ToolCapability } from './tools.js';
|
|
36
|
-
/**
|
|
37
|
-
|
|
36
|
+
/**
|
|
37
|
+
* Версия wire-протокола плагина (аналог `EXECUTOR_PROTOCOL_VERSION`).
|
|
38
|
+
*
|
|
39
|
+
* **v2** (PROP-138, Ф2) — добавлен runtime-контур: плагин, объявивший
|
|
40
|
+
* `protocol: 2` в `/capabilities`, умеет работать с `ctx.runtime` по проводу
|
|
41
|
+
* (`POST /runtime/*` через хост). Плагин v1 (runtime по проводу нет)
|
|
42
|
+
* принимается хостом как раньше — см. {@link PLUGIN_PROTOCOL_SUPPORTED_VERSIONS}.
|
|
43
|
+
*/
|
|
44
|
+
export const PLUGIN_PROTOCOL_VERSION = 2;
|
|
45
|
+
/**
|
|
46
|
+
* Старшая версия протокола, которую хост принимает (v1 — без runtime).
|
|
47
|
+
*
|
|
48
|
+
* Совместимость: хост говорит и с плагином v1 (поведение прежнее), и с
|
|
49
|
+
* плагином v2 (runtime по проводу). Вне перечня — отказ
|
|
50
|
+
* `protocol_mismatch` (fail-closed).
|
|
51
|
+
*/
|
|
52
|
+
export const PLUGIN_PROTOCOL_MIN_VERSION = 1;
|
|
53
|
+
/**
|
|
54
|
+
* Версии wire-протокола, которые принимает хост.
|
|
55
|
+
*
|
|
56
|
+
* Единственный источник истины для проверки ответа `/capabilities`
|
|
57
|
+
* ({@link checkPluginCapabilities}) — и для выбора поведения: плагин v2
|
|
58
|
+
* получает runtime-контур, плагин v1 — нет.
|
|
59
|
+
*/
|
|
60
|
+
export const PLUGIN_PROTOCOL_SUPPORTED_VERSIONS = [
|
|
61
|
+
PLUGIN_PROTOCOL_MIN_VERSION,
|
|
62
|
+
PLUGIN_PROTOCOL_VERSION,
|
|
63
|
+
];
|
|
64
|
+
/**
|
|
65
|
+
* Минимальная версия протокола, в которой есть runtime-контур
|
|
66
|
+
* (`ctx.runtime` по проводу, PROP-138 Ф2).
|
|
67
|
+
*/
|
|
68
|
+
export const PLUGIN_PROTOCOL_RUNTIME_MIN_VERSION = 2;
|
|
38
69
|
/** Пути эндпоинтов протокола (относительно базового адреса процесса). */
|
|
39
70
|
export const PLUGIN_PROTOCOL_PATHS = {
|
|
40
71
|
/** `POST` — вызов точки расширения. */
|
|
@@ -44,6 +75,27 @@ export const PLUGIN_PROTOCOL_PATHS = {
|
|
|
44
75
|
/** `GET` — процесс жив (без токена). */
|
|
45
76
|
health: '/health',
|
|
46
77
|
};
|
|
78
|
+
/**
|
|
79
|
+
* Пути runtime-контура (PROP-138, Ф2).
|
|
80
|
+
*
|
|
81
|
+
* Адреса **не** на базовом адресе процесса плагина, а на адресе
|
|
82
|
+
* host-side прокси (`SYNTH_RUNTIME_URL` в окружении процесса): плагин
|
|
83
|
+
* **не ходит** к исполнителю напрямую — единственная точка — хост.
|
|
84
|
+
*/
|
|
85
|
+
export const PLUGIN_RUNTIME_PATHS = {
|
|
86
|
+
/** `POST` — команда (argv без shell) в контуре исполнителя сессии. */
|
|
87
|
+
exec: '/runtime/exec',
|
|
88
|
+
/** `POST` — прочитать файл (base64). */
|
|
89
|
+
fsRead: '/runtime/fs/read',
|
|
90
|
+
/** `POST` — записать файл (base64). */
|
|
91
|
+
fsWrite: '/runtime/fs/write',
|
|
92
|
+
/** `POST` — сведения о файле/каталоге. */
|
|
93
|
+
fsStat: '/runtime/fs/stat',
|
|
94
|
+
/** `POST` — записи каталога. */
|
|
95
|
+
fsReaddir: '/runtime/fs/readdir',
|
|
96
|
+
/** `POST` — канонический путь. */
|
|
97
|
+
fsRealpath: '/runtime/fs/realpath',
|
|
98
|
+
};
|
|
47
99
|
/**
|
|
48
100
|
* Строка готовности, которую сервер плагина печатает в **stdout** при старте
|
|
49
101
|
* (Ф4б-2). Хост читает stdout процесса до этой строки и берёт из неё порт.
|
|
@@ -123,6 +175,26 @@ export const PLUGIN_PROTOCOL_ERROR_STATUS = {
|
|
|
123
175
|
export function isPluginProtocolErrorReason(value) {
|
|
124
176
|
return PLUGIN_PROTOCOL_ERROR_REASONS.includes(value);
|
|
125
177
|
}
|
|
178
|
+
/**
|
|
179
|
+
* Версия протокола, которую принимает хост (fail-closed вне перечня).
|
|
180
|
+
*
|
|
181
|
+
* Единственная точка проверки: и `checkPluginCapabilities`, и выбор
|
|
182
|
+
* runtime-контура (плагин v2) опираются на неё.
|
|
183
|
+
*/
|
|
184
|
+
export function isSupportedPluginProtocolVersion(value) {
|
|
185
|
+
return (typeof value === 'number' &&
|
|
186
|
+
PLUGIN_PROTOCOL_SUPPORTED_VERSIONS.includes(value));
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Понимает ли плагин runtime-контур (PROP-138, Ф2).
|
|
190
|
+
*
|
|
191
|
+
* `true` — плагин объявил версию протокола с runtime-контуром: хот может
|
|
192
|
+
* отдавать `ctx.runtime` по проводу. `false` — плагин v1: поведение прежнее
|
|
193
|
+
* (runtime по проводу нет).
|
|
194
|
+
*/
|
|
195
|
+
export function pluginProtocolSupportsRuntime(protocol) {
|
|
196
|
+
return protocol >= PLUGIN_PROTOCOL_RUNTIME_MIN_VERSION;
|
|
197
|
+
}
|
|
126
198
|
/** Значение — известная точка протокола. */
|
|
127
199
|
export function isPluginProtocolPoint(value) {
|
|
128
200
|
return PLUGIN_PROTOCOL_POINTS.includes(value);
|
|
@@ -162,8 +234,9 @@ export function checkPluginCapabilities(payload, expected) {
|
|
|
162
234
|
if (typeof protocol !== 'number' || !Number.isFinite(protocol)) {
|
|
163
235
|
return fail('invalid_request', 'в ответе /capabilities нет числового поля protocol');
|
|
164
236
|
}
|
|
165
|
-
if (protocol
|
|
166
|
-
return fail('protocol_mismatch', `плагин говорит по протоколу ${protocol}, а Synth
|
|
237
|
+
if (!isSupportedPluginProtocolVersion(protocol)) {
|
|
238
|
+
return fail('protocol_mismatch', `плагин говорит по протоколу ${protocol}, а Synth принимает ` +
|
|
239
|
+
`${PLUGIN_PROTOCOL_SUPPORTED_VERSIONS.join('/')}`);
|
|
167
240
|
}
|
|
168
241
|
const name = payload.name;
|
|
169
242
|
const version = payload.version;
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-133 §1: единая точка истины по доступу к проекту.
|
|
3
|
+
*
|
|
4
|
+
* Модуль **browser-safe**: только типы и чистые функции, без `node:*` и без
|
|
5
|
+
* `zod` (читают и ядро, и UI, и драйвер PostgreSQL).
|
|
6
|
+
*
|
|
7
|
+
* Порядок резолва (первое совпадение выигрывает, дальше не идём) — PROP-133 §1:
|
|
8
|
+
*
|
|
9
|
+
* 1. владелец проекта (`ownerId === userId`) → `owner`;
|
|
10
|
+
* 2. глобальная роль инстанса `ADMIN`/`LEAD` → `owner` (сквозной обзор);
|
|
11
|
+
* 3. пользовательский грант (`members[userId]`) → эта роль;
|
|
12
|
+
* 4. максимальная роль по группам (`groupMembers` среди `groups`) — `owner` >
|
|
13
|
+
* `editor` > `viewer`;
|
|
14
|
+
* 5. `everyoneRole` (если задан) → эта роль;
|
|
15
|
+
* 6. иначе — доступа нет (`read: false`, `role: null`).
|
|
16
|
+
*
|
|
17
|
+
* `read` = `role !== null`. Неизвестное значение роли в данных (битая запись,
|
|
18
|
+
* легаси) — **fail-closed** в `viewer` (как `normalizeParticipantRole`,
|
|
19
|
+
* ADR-106 Ф4).
|
|
20
|
+
*/
|
|
21
|
+
import { ProjectRole, type Project } from './project.js';
|
|
22
|
+
/** Каноническая роль доступа к проекту (строковое значение). */
|
|
23
|
+
export type ProjectAccessRoleValue = 'owner' | 'editor' | 'viewer';
|
|
24
|
+
/**
|
|
25
|
+
* PROP-133: роль доступа к проекту; `null` — доступа нет.
|
|
26
|
+
*/
|
|
27
|
+
export type ProjectAccessRole = ProjectAccessRoleValue | null;
|
|
28
|
+
/**
|
|
29
|
+
* PROP-133: кто запрашивает доступ (роль инстанса + группы пользователя).
|
|
30
|
+
*/
|
|
31
|
+
export interface ProjectPrincipal {
|
|
32
|
+
/** Идентификатор пользователя (владелец сессии/проекта). */
|
|
33
|
+
userId: string;
|
|
34
|
+
/** Глобальные роли инстанса (`ADMIN`/`LEAD` — сквозной обзор). */
|
|
35
|
+
roles?: readonly string[];
|
|
36
|
+
/** Группы пользователя (субъект грантов по группам). */
|
|
37
|
+
groups?: readonly string[];
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* PROP-133: читатель списка проектов — пользователь и его группы.
|
|
41
|
+
*
|
|
42
|
+
* Отдельный тип от `ProjectPrincipal`: у «просто читателя списка» нет ролей
|
|
43
|
+
* инстанса (`ADMIN`/`LEAD` получают весь список без аргумента — см. порт
|
|
44
|
+
* `ProjectRepository.list`).
|
|
45
|
+
*/
|
|
46
|
+
export interface ProjectViewer {
|
|
47
|
+
userId: string;
|
|
48
|
+
groups?: readonly string[];
|
|
49
|
+
}
|
|
50
|
+
/** PROP-133: решение по доступу к проекту. */
|
|
51
|
+
export interface ProjectAccess {
|
|
52
|
+
/** Есть ли право чтения (`role !== null`). */
|
|
53
|
+
read: boolean;
|
|
54
|
+
/** Роль доступа (`null` — доступа нет). */
|
|
55
|
+
role: ProjectAccessRole;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* PROP-133: нормализация роли доступа — неизвестное значение **fail-closed**
|
|
59
|
+
* (`viewer`, только чтение).
|
|
60
|
+
*/
|
|
61
|
+
export declare function normalizeProjectAccessRole(value: unknown): ProjectAccessRoleValue;
|
|
62
|
+
/**
|
|
63
|
+
* PROP-133: нормализация карты грантов (пользователь → роль) при чтении.
|
|
64
|
+
*
|
|
65
|
+
* Не-объект → пустая карта; неизвестная роль → `viewer`; пустой ключ
|
|
66
|
+
* отбрасывается.
|
|
67
|
+
*/
|
|
68
|
+
export declare function normalizeProjectMemberRoles(value: unknown): Record<string, ProjectRole>;
|
|
69
|
+
/**
|
|
70
|
+
* PROP-133: нормализация роли «всем пользователям» при чтении.
|
|
71
|
+
*
|
|
72
|
+
* - `undefined` — поле отсутствует (проект не опубликован);
|
|
73
|
+
* - `null` — явное «не опубликован»;
|
|
74
|
+
* - `owner`/`editor`/`viewer` — как есть;
|
|
75
|
+
* - нечто иное (битая запись) — `undefined` (fail-closed: проект **не**
|
|
76
|
+
* опубликован, доступ для всех не выдаётся).
|
|
77
|
+
*/
|
|
78
|
+
export declare function normalizeProjectEveryoneRole(value: unknown): ProjectRole | null | undefined;
|
|
79
|
+
/**
|
|
80
|
+
* PROP-133 §1: единый резолвер доступа к проекту.
|
|
81
|
+
*
|
|
82
|
+
* Первое совпадение выигрывает (дальше не идём) — порядок см. в шапке модуля.
|
|
83
|
+
*/
|
|
84
|
+
export declare function resolveProjectAccess(project: Pick<Project, 'ownerId' | 'members' | 'groupMembers' | 'everyoneRole'>, principal: ProjectPrincipal): ProjectAccess;
|
|
85
|
+
/**
|
|
86
|
+
* PROP-133: право изменения содержимого проекта — `owner`/`editor`.
|
|
87
|
+
* Грант `viewer` записи не даёт (инвариант 21).
|
|
88
|
+
*/
|
|
89
|
+
export declare function canWriteWithProjectRole(role: ProjectAccessRole): boolean;
|
|
90
|
+
/**
|
|
91
|
+
* PROP-133: право управления доступом к проекту — только `owner`
|
|
92
|
+
* (гранты `viewer`/`editor` записи не дают).
|
|
93
|
+
*/
|
|
94
|
+
export declare function canManageWithProjectRole(role: ProjectAccessRole): boolean;
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-133 §1: единая точка истины по доступу к проекту.
|
|
3
|
+
*
|
|
4
|
+
* Модуль **browser-safe**: только типы и чистые функции, без `node:*` и без
|
|
5
|
+
* `zod` (читают и ядро, и UI, и драйвер PostgreSQL).
|
|
6
|
+
*
|
|
7
|
+
* Порядок резолва (первое совпадение выигрывает, дальше не идём) — PROP-133 §1:
|
|
8
|
+
*
|
|
9
|
+
* 1. владелец проекта (`ownerId === userId`) → `owner`;
|
|
10
|
+
* 2. глобальная роль инстанса `ADMIN`/`LEAD` → `owner` (сквозной обзор);
|
|
11
|
+
* 3. пользовательский грант (`members[userId]`) → эта роль;
|
|
12
|
+
* 4. максимальная роль по группам (`groupMembers` среди `groups`) — `owner` >
|
|
13
|
+
* `editor` > `viewer`;
|
|
14
|
+
* 5. `everyoneRole` (если задан) → эта роль;
|
|
15
|
+
* 6. иначе — доступа нет (`read: false`, `role: null`).
|
|
16
|
+
*
|
|
17
|
+
* `read` = `role !== null`. Неизвестное значение роли в данных (битая запись,
|
|
18
|
+
* легаси) — **fail-closed** в `viewer` (как `normalizeParticipantRole`,
|
|
19
|
+
* ADR-106 Ф4).
|
|
20
|
+
*/
|
|
21
|
+
import { ProjectRole } from './project.js';
|
|
22
|
+
/** Глобальные роли инстанса со сквозным обзором (PROP-133 §1, п. 2). */
|
|
23
|
+
const ELEVATED_INSTANCE_ROLES = ['ADMIN', 'LEAD'];
|
|
24
|
+
/** Вес роли для выбора максимума по группам (`owner` > `editor` > `viewer`). */
|
|
25
|
+
const ROLE_RANK = {
|
|
26
|
+
owner: 3,
|
|
27
|
+
editor: 2,
|
|
28
|
+
viewer: 1,
|
|
29
|
+
};
|
|
30
|
+
/** Канонические значения ролей → enum `ProjectRole` (для полей `Project`). */
|
|
31
|
+
const ROLE_BY_VALUE = {
|
|
32
|
+
owner: ProjectRole.OWNER,
|
|
33
|
+
editor: ProjectRole.EDITOR,
|
|
34
|
+
viewer: ProjectRole.VIEWER,
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* PROP-133: нормализация роли доступа — неизвестное значение **fail-closed**
|
|
38
|
+
* (`viewer`, только чтение).
|
|
39
|
+
*/
|
|
40
|
+
export function normalizeProjectAccessRole(value) {
|
|
41
|
+
if (value === 'owner' || value === 'editor' || value === 'viewer')
|
|
42
|
+
return value;
|
|
43
|
+
return 'viewer';
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* PROP-133: нормализация карты грантов (пользователь → роль) при чтении.
|
|
47
|
+
*
|
|
48
|
+
* Не-объект → пустая карта; неизвестная роль → `viewer`; пустой ключ
|
|
49
|
+
* отбрасывается.
|
|
50
|
+
*/
|
|
51
|
+
export function normalizeProjectMemberRoles(value) {
|
|
52
|
+
const out = {};
|
|
53
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
54
|
+
return out;
|
|
55
|
+
for (const [key, role] of Object.entries(value)) {
|
|
56
|
+
if (!key)
|
|
57
|
+
continue;
|
|
58
|
+
out[key] = ROLE_BY_VALUE[normalizeProjectAccessRole(role)];
|
|
59
|
+
}
|
|
60
|
+
return out;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* PROP-133: нормализация роли «всем пользователям» при чтении.
|
|
64
|
+
*
|
|
65
|
+
* - `undefined` — поле отсутствует (проект не опубликован);
|
|
66
|
+
* - `null` — явное «не опубликован»;
|
|
67
|
+
* - `owner`/`editor`/`viewer` — как есть;
|
|
68
|
+
* - нечто иное (битая запись) — `undefined` (fail-closed: проект **не**
|
|
69
|
+
* опубликован, доступ для всех не выдаётся).
|
|
70
|
+
*/
|
|
71
|
+
export function normalizeProjectEveryoneRole(value) {
|
|
72
|
+
if (value === undefined)
|
|
73
|
+
return undefined;
|
|
74
|
+
if (value === null)
|
|
75
|
+
return null;
|
|
76
|
+
if (value === 'owner' || value === 'editor' || value === 'viewer') {
|
|
77
|
+
return ROLE_BY_VALUE[value];
|
|
78
|
+
}
|
|
79
|
+
return undefined;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* PROP-133 §1: единый резолвер доступа к проекту.
|
|
83
|
+
*
|
|
84
|
+
* Первое совпадение выигрывает (дальше не идём) — порядок см. в шапке модуля.
|
|
85
|
+
*/
|
|
86
|
+
export function resolveProjectAccess(project, principal) {
|
|
87
|
+
// 1. Владелец проекта.
|
|
88
|
+
if (project.ownerId && project.ownerId === principal.userId) {
|
|
89
|
+
return { read: true, role: 'owner' };
|
|
90
|
+
}
|
|
91
|
+
// 2. Сквозной обзор (`ADMIN`/`LEAD`) — сравнение без учёта регистра.
|
|
92
|
+
const roles = principal.roles ?? [];
|
|
93
|
+
for (const role of roles) {
|
|
94
|
+
if (typeof role !== 'string')
|
|
95
|
+
continue;
|
|
96
|
+
const upper = role.trim().toUpperCase();
|
|
97
|
+
if (ELEVATED_INSTANCE_ROLES.includes(upper)) {
|
|
98
|
+
return { read: true, role: 'owner' };
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
// 3. Пользовательский грант.
|
|
102
|
+
const memberRole = project.members?.[principal.userId];
|
|
103
|
+
if (memberRole !== undefined) {
|
|
104
|
+
return { read: true, role: normalizeProjectAccessRole(memberRole) };
|
|
105
|
+
}
|
|
106
|
+
// 4. Гранты по группам — максимальная роль среди групп пользователя.
|
|
107
|
+
const groups = principal.groups ?? [];
|
|
108
|
+
let groupRole = null;
|
|
109
|
+
for (const group of groups) {
|
|
110
|
+
const granted = project.groupMembers?.[group];
|
|
111
|
+
if (granted === undefined)
|
|
112
|
+
continue;
|
|
113
|
+
const role = normalizeProjectAccessRole(granted);
|
|
114
|
+
if (groupRole === null || ROLE_RANK[role] > ROLE_RANK[groupRole])
|
|
115
|
+
groupRole = role;
|
|
116
|
+
}
|
|
117
|
+
if (groupRole !== null)
|
|
118
|
+
return { read: true, role: groupRole };
|
|
119
|
+
// 5. Режим «всем пользователям».
|
|
120
|
+
const everyone = project.everyoneRole;
|
|
121
|
+
if (everyone !== undefined && everyone !== null) {
|
|
122
|
+
return { read: true, role: normalizeProjectAccessRole(everyone) };
|
|
123
|
+
}
|
|
124
|
+
// 6. Доступа нет.
|
|
125
|
+
return { read: false, role: null };
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* PROP-133: право изменения содержимого проекта — `owner`/`editor`.
|
|
129
|
+
* Грант `viewer` записи не даёт (инвариант 21).
|
|
130
|
+
*/
|
|
131
|
+
export function canWriteWithProjectRole(role) {
|
|
132
|
+
return role === 'owner' || role === 'editor';
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* PROP-133: право управления доступом к проекту — только `owner`
|
|
136
|
+
* (гранты `viewer`/`editor` записи не дают).
|
|
137
|
+
*/
|
|
138
|
+
export function canManageWithProjectRole(role) {
|
|
139
|
+
return role === 'owner';
|
|
140
|
+
}
|
package/dist/types/project.d.ts
CHANGED
|
@@ -22,7 +22,31 @@ export interface ProjectLogEntry {
|
|
|
22
22
|
createdAt: string;
|
|
23
23
|
sessionId?: string;
|
|
24
24
|
author?: string;
|
|
25
|
+
/**
|
|
26
|
+
* PROP-054: аддитивные поля правки записи журнала — кто и когда изменил
|
|
27
|
+
* текст. Старые записи их не имеют (необязательные).
|
|
28
|
+
*/
|
|
29
|
+
updatedAt?: string;
|
|
30
|
+
updatedBy?: string;
|
|
25
31
|
}
|
|
32
|
+
/**
|
|
33
|
+
* PROP-054: лимиты Markdown-полей проекта/сессии (в **байтах**).
|
|
34
|
+
*
|
|
35
|
+
* Единый источник истины для HTTP-роутов и инструментов: превышение →
|
|
36
|
+
* `400 VALIDATION_ERROR`. Значения:
|
|
37
|
+
* - `invariants` — 64 КиБ (инварианты попадают в системный промпт);
|
|
38
|
+
* - `journalEntry` — 16 КиБ (запись журнала проекта);
|
|
39
|
+
* - `planDescription` — 16 КиБ (описание пункта плана);
|
|
40
|
+
* - `todoContent` — 4 КиБ (текст пункта ToDo сессии).
|
|
41
|
+
*/
|
|
42
|
+
export declare const MARKDOWN_LIMITS: {
|
|
43
|
+
readonly invariants: number;
|
|
44
|
+
readonly journalEntry: number;
|
|
45
|
+
readonly planDescription: number;
|
|
46
|
+
readonly todoContent: number;
|
|
47
|
+
};
|
|
48
|
+
/** Имя поля Markdown-лимита (ключ `MARKDOWN_LIMITS`). */
|
|
49
|
+
export type MarkdownLimitKey = keyof typeof MARKDOWN_LIMITS;
|
|
26
50
|
/**
|
|
27
51
|
* ADR-071 §2.4/§2.5: проектный скоуп MCP — ссылки на записи единого реестра по
|
|
28
52
|
* имени.
|
|
@@ -35,9 +59,15 @@ export interface ProjectLogEntry {
|
|
|
35
59
|
export interface ProjectMcpSettings {
|
|
36
60
|
enabled: string[];
|
|
37
61
|
defaultOn: string[];
|
|
62
|
+
/**
|
|
63
|
+
* PROP-125: имена серверных MCP-дефолтов, уже применённых к проекту при
|
|
64
|
+
* подключении гибрида (идемпотентный авто-сид). Выключенный пользователем
|
|
65
|
+
* сервер повторно не добавляется.
|
|
66
|
+
*/
|
|
67
|
+
remoteSeeded?: string[];
|
|
38
68
|
}
|
|
39
69
|
/**
|
|
40
|
-
* ADR-
|
|
70
|
+
* ADR-126 §11: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
|
|
41
71
|
* - `enabled` — hard-gate: доступные проекту скиллы. Пустой массив — «всё
|
|
42
72
|
* выключено» (opt-in); отсутствие `project.skills` — гейт не задан (legacy).
|
|
43
73
|
* - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот
|
|
@@ -47,6 +77,35 @@ export interface ProjectSkillSettings {
|
|
|
47
77
|
enabled: string[];
|
|
48
78
|
defaultOn: string[];
|
|
49
79
|
}
|
|
80
|
+
/**
|
|
81
|
+
* PROP-135 Ф6a: профиль исполнения проекта.
|
|
82
|
+
*
|
|
83
|
+
* - `profile` — имя профиля из `execution.remote.profiles` для сессий проекта
|
|
84
|
+
* (если сессия и агент свой профиль не задали). Не задан — наследуется
|
|
85
|
+
* `execution.remote.defaultProfile`;
|
|
86
|
+
* - `allowedProfiles` — **потолок**: если массив задан, сессия проекта не может
|
|
87
|
+
* исполняться на профиле вне списка (выбор сессии/агента/проекта проверяется
|
|
88
|
+
* при каждом ходе; нарушение — fail-closed: запрещённый профиль не
|
|
89
|
+
* выбирается, инстанс-дефолт — **не исключение**). Пустой массив — «профилей
|
|
90
|
+
* нет»; массив не задан (`undefined`) — потолок не задан (обратная
|
|
91
|
+
* совместимость: старые проекты не имеют поля).
|
|
92
|
+
*/
|
|
93
|
+
export interface ProjectExecutorSettings {
|
|
94
|
+
profile?: string;
|
|
95
|
+
allowedProfiles?: string[];
|
|
96
|
+
/**
|
|
97
|
+
* PROP-135 (браузерный контур): профиль браузерного пула для сессий проекта
|
|
98
|
+
* (если сессия и агент свой профиль не задали). Отдельный каталог:
|
|
99
|
+
* проверяется по `execution.remote.browserProfiles`, а не по exec-профилям.
|
|
100
|
+
*/
|
|
101
|
+
browserProfile?: string;
|
|
102
|
+
/**
|
|
103
|
+
* PROP-135 (браузерный контур): **потолок** браузерных профилей проекта.
|
|
104
|
+
* Заданный список — профиль обязан в него входить (пустой — «профилей
|
|
105
|
+
* нет»); не задан — потолок не задан.
|
|
106
|
+
*/
|
|
107
|
+
allowedBrowserProfiles?: string[];
|
|
108
|
+
}
|
|
50
109
|
/**
|
|
51
110
|
* ADR-107: память проекта (undefined — наследует политику инстанса/включена).
|
|
52
111
|
*/
|
|
@@ -79,6 +138,15 @@ export interface Project {
|
|
|
79
138
|
name: string;
|
|
80
139
|
ownerId: string;
|
|
81
140
|
members: Record<string, ProjectRole>;
|
|
141
|
+
/**
|
|
142
|
+
* PROP-133: гранты группам (имя группы → роль). Отсутствует — групп нет.
|
|
143
|
+
*/
|
|
144
|
+
groupMembers?: Record<string, ProjectRole>;
|
|
145
|
+
/**
|
|
146
|
+
* PROP-133: роль для всех пользователей инстанса; null/undefined — проект
|
|
147
|
+
* не опубликован.
|
|
148
|
+
*/
|
|
149
|
+
everyoneRole?: ProjectRole | null;
|
|
82
150
|
description: string;
|
|
83
151
|
currentTask: string;
|
|
84
152
|
invariants: string;
|
|
@@ -93,10 +161,12 @@ export interface Project {
|
|
|
93
161
|
worktreeSetupScript?: string;
|
|
94
162
|
/** ADR-071 §2.4: проектный скоуп MCP (owner/lead). */
|
|
95
163
|
mcp?: ProjectMcpSettings;
|
|
96
|
-
/** ADR-
|
|
164
|
+
/** ADR-126 §11: проектный скоуп скиллов (owner/lead). */
|
|
97
165
|
skills?: ProjectSkillSettings;
|
|
98
166
|
/** ADR-107: память проекта (undefined — наследует политику инстанса/включена). */
|
|
99
167
|
memory?: ProjectMemorySettings;
|
|
168
|
+
/** PROP-135 Ф6a: профиль исполнения проекта и потолок разрешённых профилей. */
|
|
169
|
+
executor?: ProjectExecutorSettings;
|
|
100
170
|
statusMessages: StatusMessage[];
|
|
101
171
|
/** Kanban-план проекта (ADR-039). Владеет проектом, а не сессией. */
|
|
102
172
|
plan?: ProjectPlan;
|
|
@@ -105,6 +175,23 @@ export interface Project {
|
|
|
105
175
|
createdAt: string;
|
|
106
176
|
updatedAt: string;
|
|
107
177
|
}
|
|
178
|
+
/**
|
|
179
|
+
* PROP-133: производное состояние доступа (не хранится в проекте).
|
|
180
|
+
*
|
|
181
|
+
* - `author` — проект видит только автор (плюс `ADMIN`/`LEAD` — сквозной обзор);
|
|
182
|
+
* - `selected` — есть пользовательский и/или групповой грант;
|
|
183
|
+
* - `all` — проект опубликован для всех (`everyoneRole` задан).
|
|
184
|
+
*/
|
|
185
|
+
export type ProjectVisibility = 'author' | 'selected' | 'all';
|
|
186
|
+
/**
|
|
187
|
+
* PROP-133: состояние доступа по состоянию списка доступа.
|
|
188
|
+
*
|
|
189
|
+
* Порядок: `everyoneRole` задан → `all`; иначе есть грант пользователю (кроме
|
|
190
|
+
* владельца) или группе → `selected`; иначе → `author`. Значения ролей не
|
|
191
|
+
* проверяются: битая роль не должна ронять вывод (fail-closed — на резолвере
|
|
192
|
+
* доступа, `resolveProjectAccess`).
|
|
193
|
+
*/
|
|
194
|
+
export declare function deriveProjectVisibility(project: Pick<Project, 'ownerId' | 'members' | 'groupMembers' | 'everyoneRole'>): ProjectVisibility;
|
|
108
195
|
/**
|
|
109
196
|
* Канонические ключи иконок проектов и сессий (единый список для server и UI).
|
|
110
197
|
* Значения — только ключи реестра (загружаемые картинки не поддерживаются).
|
package/dist/types/project.js
CHANGED
|
@@ -12,6 +12,42 @@ export var StatusMessageType;
|
|
|
12
12
|
StatusMessageType["ERROR"] = "error";
|
|
13
13
|
StatusMessageType["STREAM"] = "stream";
|
|
14
14
|
})(StatusMessageType || (StatusMessageType = {}));
|
|
15
|
+
/**
|
|
16
|
+
* PROP-054: лимиты Markdown-полей проекта/сессии (в **байтах**).
|
|
17
|
+
*
|
|
18
|
+
* Единый источник истины для HTTP-роутов и инструментов: превышение →
|
|
19
|
+
* `400 VALIDATION_ERROR`. Значения:
|
|
20
|
+
* - `invariants` — 64 КиБ (инварианты попадают в системный промпт);
|
|
21
|
+
* - `journalEntry` — 16 КиБ (запись журнала проекта);
|
|
22
|
+
* - `planDescription` — 16 КиБ (описание пункта плана);
|
|
23
|
+
* - `todoContent` — 4 КиБ (текст пункта ToDo сессии).
|
|
24
|
+
*/
|
|
25
|
+
export const MARKDOWN_LIMITS = {
|
|
26
|
+
invariants: 64 * 1024,
|
|
27
|
+
journalEntry: 16 * 1024,
|
|
28
|
+
planDescription: 16 * 1024,
|
|
29
|
+
todoContent: 4 * 1024,
|
|
30
|
+
};
|
|
31
|
+
/**
|
|
32
|
+
* PROP-133: состояние доступа по состоянию списка доступа.
|
|
33
|
+
*
|
|
34
|
+
* Порядок: `everyoneRole` задан → `all`; иначе есть грант пользователю (кроме
|
|
35
|
+
* владельца) или группе → `selected`; иначе → `author`. Значения ролей не
|
|
36
|
+
* проверяются: битая роль не должна ронять вывод (fail-closed — на резолвере
|
|
37
|
+
* доступа, `resolveProjectAccess`).
|
|
38
|
+
*/
|
|
39
|
+
export function deriveProjectVisibility(project) {
|
|
40
|
+
if (project.everyoneRole !== undefined && project.everyoneRole !== null)
|
|
41
|
+
return 'all';
|
|
42
|
+
const members = project.members ?? {};
|
|
43
|
+
const hasUserGrant = Object.keys(members).some((userId) => userId !== project.ownerId);
|
|
44
|
+
if (hasUserGrant)
|
|
45
|
+
return 'selected';
|
|
46
|
+
const groupMembers = project.groupMembers ?? {};
|
|
47
|
+
if (Object.keys(groupMembers).length > 0)
|
|
48
|
+
return 'selected';
|
|
49
|
+
return 'author';
|
|
50
|
+
}
|
|
15
51
|
/**
|
|
16
52
|
* Канонические ключи иконок проектов и сессий (единый список для server и UI).
|
|
17
53
|
* Значения — только ключи реестра (загружаемые картинки не поддерживаются).
|
package/dist/types/prompt.d.ts
CHANGED
|
@@ -152,9 +152,11 @@ export interface PromptToolDetail {
|
|
|
152
152
|
* `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
|
|
153
153
|
* `dependency` (в окружении нет нужной программы — git/rg/sh),
|
|
154
154
|
* `workspace` (не задан рабочий каталог проекта),
|
|
155
|
-
* `storage` (хранилище недоступно — деградированный read-only режим, ADR-098)
|
|
155
|
+
* `storage` (хранилище недоступно — деградированный read-only режим, ADR-098),
|
|
156
|
+
* `policy` (политика инстанса запрещает тул в текущем режиме — PROP-124 §0:
|
|
157
|
+
* адресные ssh-тулы в режиме `ssh.mode = 'agent'`).
|
|
156
158
|
*/
|
|
157
|
-
reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace' | 'storage';
|
|
159
|
+
reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace' | 'storage' | 'policy';
|
|
158
160
|
/** ADR-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
|
|
159
161
|
source: 'built-in';
|
|
160
162
|
/** ADR-071 §2.6: длина `JSON.stringify` LLM-определения тула (как слой `tools`). */
|
|
@@ -6,10 +6,18 @@
|
|
|
6
6
|
* маршрутизацию в сессию выполняет `EventRouter` (seam — `RouteRuleProvider`).
|
|
7
7
|
* Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
|
|
8
8
|
*/
|
|
9
|
+
/**
|
|
10
|
+
* PROP-141: код «проект расписания не определён».
|
|
11
|
+
*
|
|
12
|
+
* Запись без проекта **не теряется** — она остаётся в реестре, но
|
|
13
|
+
* отключается и помечается этой строкой в `lastError` (не срабатывает).
|
|
14
|
+
*/
|
|
15
|
+
export declare const SCHEDULE_PROJECT_REQUIRED_ERROR = "project_required";
|
|
9
16
|
/**
|
|
10
17
|
* ADR-051/ADR-089: цель срабатывания расписания.
|
|
11
18
|
* - `bound` — постоянная сессия (событие уходит в неё);
|
|
12
|
-
* - `ephemeral` — разовая сессия с TTL и авто-архивом;
|
|
19
|
+
* - `ephemeral` — разовая сессия с TTL и авто-архивом; проект обязателен
|
|
20
|
+
* (PROP-141: инстансных автоматизаций нет);
|
|
13
21
|
* - `queue` — не запускать сразу, отложить владельцу;
|
|
14
22
|
* - `pipeline` — прямой запуск прогона пайплайна (ADR-101): событие в Router
|
|
15
23
|
* **не** публикуется, шедулер запускает прогон сам.
|
|
@@ -20,7 +28,7 @@ export type ScheduleTarget = {
|
|
|
20
28
|
} | {
|
|
21
29
|
mode: 'ephemeral';
|
|
22
30
|
agentTemplate?: string;
|
|
23
|
-
project
|
|
31
|
+
project: string;
|
|
24
32
|
ttl?: string;
|
|
25
33
|
} | {
|
|
26
34
|
mode: 'queue';
|
|
@@ -36,6 +44,16 @@ export type ScheduleTarget = {
|
|
|
36
44
|
/** Данные входа прогона → trigger.payload.* (напр. {sessionId}). */
|
|
37
45
|
payload?: Record<string, unknown>;
|
|
38
46
|
};
|
|
47
|
+
/**
|
|
48
|
+
* PROP-141: проект расписания, выводимый **из цели** (без обращения к
|
|
49
|
+
* хранилищу).
|
|
50
|
+
*
|
|
51
|
+
* - `pipeline` → `target.projectId` (проект-владелец пайплайна);
|
|
52
|
+
* - `ephemeral` → `target.project`;
|
|
53
|
+
* - `bound`/`queue` → `undefined`: проект берётся у сессии-цели, а её
|
|
54
|
+
* разрешает резолвер «сессия → проект» (задаёт composition root).
|
|
55
|
+
*/
|
|
56
|
+
export declare function deriveScheduleProjectId(target: ScheduleTarget): string | undefined;
|
|
39
57
|
/** ADR-051/ADR-089: статус последнего запуска расписания. */
|
|
40
58
|
export type ScheduleRunStatus = 'ok' | 'error' | 'skipped';
|
|
41
59
|
/**
|
|
@@ -99,6 +117,15 @@ export interface Schedule {
|
|
|
99
117
|
id: string;
|
|
100
118
|
name: string;
|
|
101
119
|
enabled: boolean;
|
|
120
|
+
/**
|
|
121
|
+
* PROP-141: проект-владелец расписания. **Обязателен**: инстансных
|
|
122
|
+
* автоматизаций нет — каждое расписание принадлежит проекту.
|
|
123
|
+
*
|
|
124
|
+
* Пустая строка — проект определить не удалось (легаси-запись, у которой
|
|
125
|
+
* цель без проекта): такая запись отключается, помечается
|
|
126
|
+
* `lastError = 'project_required'` и **не срабатывает**.
|
|
127
|
+
*/
|
|
128
|
+
projectId: string;
|
|
102
129
|
/** Cron-выражение из 5 полей (`minute hour day-of-month month day-of-week`), UTC. */
|
|
103
130
|
cron?: string;
|
|
104
131
|
/** Интервал `30s | 15m | 1h | 24h`. */
|
|
@@ -128,5 +155,24 @@ export interface Schedule {
|
|
|
128
155
|
/**
|
|
129
156
|
* ADR-051/ADR-089: вход создания/обновления расписания — без служебных полей,
|
|
130
157
|
* которыми управляет хранилище/сервис (`id`, таймстемпы, статус последнего запуска).
|
|
158
|
+
*
|
|
159
|
+
* PROP-141: `projectId` — денормализованный проект расписания. Для новых
|
|
160
|
+
* записей он **обязателен**, но задаёт его сервер (выводит из цели расписания),
|
|
161
|
+
* поэтому в типе входа поле необязательное: клиент не обязан дублировать
|
|
162
|
+
* серверное поле. Запись без проекта стор отключает (`project_required`).
|
|
163
|
+
*/
|
|
164
|
+
export type ScheduleInput = Omit<Schedule, 'id' | 'createdAt' | 'updatedAt' | 'lastRunAt' | 'nextRunAt' | 'lastStatus' | 'lastError' | 'projectId'> & {
|
|
165
|
+
/** PROP-141: проект расписания (см. `Schedule.projectId`). */
|
|
166
|
+
projectId?: string;
|
|
167
|
+
};
|
|
168
|
+
/**
|
|
169
|
+
* PROP-141: привести запись расписания к контракту «проект обязателен».
|
|
170
|
+
*
|
|
171
|
+
* Чистая функция (общий контракт для файлового/в-памяти/PG-сторов):
|
|
172
|
+
* - проект уже есть — запись не меняется;
|
|
173
|
+
* - проект выводится из цели (`pipeline`/`ephemeral`) — проставляется;
|
|
174
|
+
* - вывести нельзя (`bound`/`queue` без резолвера «сессия → проект») — запись
|
|
175
|
+
* **не теряется**: она отключается и помечается `project_required`
|
|
176
|
+
* (не срабатывает).
|
|
131
177
|
*/
|
|
132
|
-
export
|
|
178
|
+
export declare function normalizeScheduleProject(schedule: Schedule): Schedule;
|