@itphx/synth-shared 0.10.1 → 0.12.3
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 +172 -3
- package/dist/config/env-overrides.d.ts +33 -1
- package/dist/config/env-overrides.js +191 -5
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +4 -0
- package/dist/config/index.js +4 -0
- package/dist/config/loader.js +19 -0
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1567 -0
- package/dist/config/resolve.d.ts +67 -0
- package/dist/config/resolve.js +187 -1
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1571 -2835
- package/dist/config/types.js +717 -58
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +279 -0
- package/dist/index.d.ts +24 -3
- package/dist/index.js +25 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +1014 -2231
- package/dist/schemas/index.js +222 -14
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +54 -2
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/fs.d.ts +11 -0
- package/dist/types/fs.js +11 -0
- package/dist/types/hooks.d.ts +50 -9
- package/dist/types/index.d.ts +23 -0
- package/dist/types/index.js +55 -0
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +101 -5
- package/dist/types/mcp.js +127 -5
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +31 -15
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +47 -4
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -1
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/webhooks.d.ts +1 -1
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +46 -1
- package/dist/utils/index.js +145 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Контракт «вопрос пользователю» (`ask_user`, этап 1 roadmap 0.13 — блок 1.3).
|
|
3
|
+
*
|
|
4
|
+
* Модель: агент задаёт один или несколько вопросов с вариантами ответа и ждёт
|
|
5
|
+
* решения пользователя. Вопрос — **персистентная запись** (порт
|
|
6
|
+
* `QuestionRepository`, ADR-096): она переживает реконнект UI и рестарт сервиса,
|
|
7
|
+
* поэтому ответ приходит по `id` вопроса, а не «по каналу».
|
|
8
|
+
*
|
|
9
|
+
* Здесь только контракты (типы + Zod-схемы HTTP-входа) — без бизнес-логики:
|
|
10
|
+
* запуск вопроса, ожидание ответа и таймаут живут в core.
|
|
11
|
+
*/
|
|
12
|
+
import { z } from 'zod';
|
|
13
|
+
/**
|
|
14
|
+
* Статус вопроса:
|
|
15
|
+
* - `pending` — вопрос задан, ответ не получен;
|
|
16
|
+
* - `answered` — пользователь ответил;
|
|
17
|
+
* - `cancelled` — вопрос отменён (таймаут, прерывание хода, отмена пользователем).
|
|
18
|
+
*/
|
|
19
|
+
export type QuestionStatus = 'pending' | 'answered' | 'cancelled';
|
|
20
|
+
/** Терминальные статусы вопроса — записи, которые можно чистить (`prune`). */
|
|
21
|
+
export declare const QUESTION_TERMINAL_STATUSES: readonly QuestionStatus[];
|
|
22
|
+
/** Вариант ответа на вопрос (значение `value` уходит в `answers`). */
|
|
23
|
+
export interface QuestionOption {
|
|
24
|
+
/** Машинное значение варианта (то, что возвращается в ответе). */
|
|
25
|
+
value: string;
|
|
26
|
+
/** Человекочитаемая подпись варианта. */
|
|
27
|
+
label: string;
|
|
28
|
+
/** Пояснение к варианту (необязательно). */
|
|
29
|
+
description?: string;
|
|
30
|
+
}
|
|
31
|
+
/** Один вопрос с набором вариантов ответа. */
|
|
32
|
+
export interface QuestionItem {
|
|
33
|
+
/** Текст вопроса (задаётся пользователю). */
|
|
34
|
+
question: string;
|
|
35
|
+
/** Короткий заголовок вопроса (для UI-карточки). */
|
|
36
|
+
header: string;
|
|
37
|
+
/** Варианты ответа. */
|
|
38
|
+
options: QuestionOption[];
|
|
39
|
+
/** Разрешён ли выбор нескольких вариантов. */
|
|
40
|
+
multiple?: boolean;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Персистентная запись вопроса (`qst_<uuid>`).
|
|
44
|
+
*
|
|
45
|
+
* `answers` — по индексу вопроса: `answers[i]` — список выбранных значений
|
|
46
|
+
* вариантов для `questions[i]`. Проверка «непусто для обязательного вопроса»
|
|
47
|
+
* и соответствие длины числу вопросов — на сервисе (в Zod-схеме входа их нет:
|
|
48
|
+
* длина зависит от вопроса, известного только серверу).
|
|
49
|
+
*/
|
|
50
|
+
export interface QuestionRecord {
|
|
51
|
+
/** `qst_<uuid>`, уникален в пределах инстанса. */
|
|
52
|
+
id: string;
|
|
53
|
+
/** Сессия, в которой задан вопрос. */
|
|
54
|
+
sessionId: string;
|
|
55
|
+
/** Ход сессии, в котором задан вопрос (необязательно). */
|
|
56
|
+
turnId?: string;
|
|
57
|
+
/** Вызов тула, породивший вопрос (необязательно). */
|
|
58
|
+
toolCallId?: string;
|
|
59
|
+
/** Агент, задавший вопрос (необязательно). */
|
|
60
|
+
agentRole?: string;
|
|
61
|
+
/** Список вопросов (пустой — не валидная запись). */
|
|
62
|
+
questions: QuestionItem[];
|
|
63
|
+
status: QuestionStatus;
|
|
64
|
+
/** Ответы — по индексу вопроса. */
|
|
65
|
+
answers?: string[][];
|
|
66
|
+
createdAt: string;
|
|
67
|
+
updatedAt: string;
|
|
68
|
+
/** Срок ожидания ответа (ISO-8601); после него вопрос считается истёкшим. */
|
|
69
|
+
expiresAt?: string;
|
|
70
|
+
/** Момент получения ответа (ISO-8601). */
|
|
71
|
+
answeredAt?: string;
|
|
72
|
+
/** Момент отмены вопроса (ISO-8601). */
|
|
73
|
+
cancelledAt?: string;
|
|
74
|
+
/** Причина отмены (`timeout`/`aborted`/`interrupted`/`user`/…). */
|
|
75
|
+
cancelReason?: string;
|
|
76
|
+
/** Кто ответил (идентификатор пользователя инстанса). */
|
|
77
|
+
answeredBy?: string;
|
|
78
|
+
}
|
|
79
|
+
/** Статус вопроса (канонический набор). */
|
|
80
|
+
export declare const questionStatusSchema: z.ZodEnum<{
|
|
81
|
+
pending: "pending";
|
|
82
|
+
cancelled: "cancelled";
|
|
83
|
+
answered: "answered";
|
|
84
|
+
}>;
|
|
85
|
+
/** Вариант ответа. */
|
|
86
|
+
export declare const questionOptionSchema: z.ZodObject<{
|
|
87
|
+
value: z.ZodString;
|
|
88
|
+
label: z.ZodString;
|
|
89
|
+
description: z.ZodOptional<z.ZodString>;
|
|
90
|
+
}, z.core.$strip>;
|
|
91
|
+
/** Один вопрос с вариантами. */
|
|
92
|
+
export declare const questionItemSchema: z.ZodObject<{
|
|
93
|
+
question: z.ZodString;
|
|
94
|
+
header: z.ZodString;
|
|
95
|
+
options: z.ZodArray<z.ZodObject<{
|
|
96
|
+
value: z.ZodString;
|
|
97
|
+
label: z.ZodString;
|
|
98
|
+
description: z.ZodOptional<z.ZodString>;
|
|
99
|
+
}, z.core.$strip>>;
|
|
100
|
+
multiple: z.ZodOptional<z.ZodBoolean>;
|
|
101
|
+
}, z.core.$strip>;
|
|
102
|
+
/**
|
|
103
|
+
* Полная запись вопроса (ответы API). Поле `answers` — массив массивов
|
|
104
|
+
* (`answers[i]` — выбранные значения вариантов для `questions[i]`).
|
|
105
|
+
*/
|
|
106
|
+
export declare const questionRecordSchema: z.ZodObject<{
|
|
107
|
+
id: z.ZodString;
|
|
108
|
+
sessionId: z.ZodString;
|
|
109
|
+
turnId: z.ZodOptional<z.ZodString>;
|
|
110
|
+
toolCallId: z.ZodOptional<z.ZodString>;
|
|
111
|
+
agentRole: z.ZodOptional<z.ZodString>;
|
|
112
|
+
questions: z.ZodArray<z.ZodObject<{
|
|
113
|
+
question: z.ZodString;
|
|
114
|
+
header: z.ZodString;
|
|
115
|
+
options: z.ZodArray<z.ZodObject<{
|
|
116
|
+
value: z.ZodString;
|
|
117
|
+
label: z.ZodString;
|
|
118
|
+
description: z.ZodOptional<z.ZodString>;
|
|
119
|
+
}, z.core.$strip>>;
|
|
120
|
+
multiple: z.ZodOptional<z.ZodBoolean>;
|
|
121
|
+
}, z.core.$strip>>;
|
|
122
|
+
status: z.ZodEnum<{
|
|
123
|
+
pending: "pending";
|
|
124
|
+
cancelled: "cancelled";
|
|
125
|
+
answered: "answered";
|
|
126
|
+
}>;
|
|
127
|
+
answers: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
|
|
128
|
+
createdAt: z.ZodString;
|
|
129
|
+
updatedAt: z.ZodString;
|
|
130
|
+
expiresAt: z.ZodOptional<z.ZodString>;
|
|
131
|
+
answeredAt: z.ZodOptional<z.ZodString>;
|
|
132
|
+
cancelledAt: z.ZodOptional<z.ZodString>;
|
|
133
|
+
cancelReason: z.ZodOptional<z.ZodString>;
|
|
134
|
+
answeredBy: z.ZodOptional<z.ZodString>;
|
|
135
|
+
}, z.core.$strip>;
|
|
136
|
+
/**
|
|
137
|
+
* Тело ответа на вопрос (`POST` ответа пользователя).
|
|
138
|
+
*
|
|
139
|
+
* Длина `answers` равна числу заданных вопросов, каждая строка — список
|
|
140
|
+
* выбранных значений вариантов. Соответствие длины и непустота обязательных
|
|
141
|
+
* ответов проверяет **сервис** (он знает состав вопроса).
|
|
142
|
+
*/
|
|
143
|
+
export declare const questionAnswerSchema: z.ZodObject<{
|
|
144
|
+
answers: z.ZodArray<z.ZodArray<z.ZodString>>;
|
|
145
|
+
}, z.core.$strip>;
|
|
146
|
+
/** Тело отмены вопроса (`reason` — свободное пояснение). */
|
|
147
|
+
export declare const questionCancelSchema: z.ZodObject<{
|
|
148
|
+
reason: z.ZodOptional<z.ZodString>;
|
|
149
|
+
}, z.core.$strip>;
|
|
150
|
+
/** Форма входа схемы ответа (ответы — по индексу вопроса). */
|
|
151
|
+
export type QuestionAnswerInput = z.input<typeof questionAnswerSchema>;
|
|
152
|
+
/** Форма входа схемы отмены. */
|
|
153
|
+
export type QuestionCancelInput = z.input<typeof questionCancelSchema>;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Контракт «вопрос пользователю» (`ask_user`, этап 1 roadmap 0.13 — блок 1.3).
|
|
3
|
+
*
|
|
4
|
+
* Модель: агент задаёт один или несколько вопросов с вариантами ответа и ждёт
|
|
5
|
+
* решения пользователя. Вопрос — **персистентная запись** (порт
|
|
6
|
+
* `QuestionRepository`, ADR-096): она переживает реконнект UI и рестарт сервиса,
|
|
7
|
+
* поэтому ответ приходит по `id` вопроса, а не «по каналу».
|
|
8
|
+
*
|
|
9
|
+
* Здесь только контракты (типы + Zod-схемы HTTP-входа) — без бизнес-логики:
|
|
10
|
+
* запуск вопроса, ожидание ответа и таймаут живут в core.
|
|
11
|
+
*/
|
|
12
|
+
import { z } from 'zod';
|
|
13
|
+
/** Терминальные статусы вопроса — записи, которые можно чистить (`prune`). */
|
|
14
|
+
export const QUESTION_TERMINAL_STATUSES = ['answered', 'cancelled'];
|
|
15
|
+
// ── Zod-схемы (HTTP-вход и запись) ─────────────────────────────────────────────
|
|
16
|
+
/** Статус вопроса (канонический набор). */
|
|
17
|
+
export const questionStatusSchema = z.enum(['pending', 'answered', 'cancelled']);
|
|
18
|
+
/** Вариант ответа. */
|
|
19
|
+
export const questionOptionSchema = z.object({
|
|
20
|
+
value: z.string().min(1),
|
|
21
|
+
label: z.string().min(1),
|
|
22
|
+
description: z.string().optional(),
|
|
23
|
+
});
|
|
24
|
+
/** Один вопрос с вариантами. */
|
|
25
|
+
export const questionItemSchema = z.object({
|
|
26
|
+
question: z.string().min(1),
|
|
27
|
+
header: z.string().min(1),
|
|
28
|
+
options: z.array(questionOptionSchema),
|
|
29
|
+
multiple: z.boolean().optional(),
|
|
30
|
+
});
|
|
31
|
+
/**
|
|
32
|
+
* Полная запись вопроса (ответы API). Поле `answers` — массив массивов
|
|
33
|
+
* (`answers[i]` — выбранные значения вариантов для `questions[i]`).
|
|
34
|
+
*/
|
|
35
|
+
export const questionRecordSchema = z.object({
|
|
36
|
+
id: z.string().min(1),
|
|
37
|
+
sessionId: z.string().min(1),
|
|
38
|
+
turnId: z.string().optional(),
|
|
39
|
+
toolCallId: z.string().optional(),
|
|
40
|
+
agentRole: z.string().optional(),
|
|
41
|
+
questions: z.array(questionItemSchema),
|
|
42
|
+
status: questionStatusSchema,
|
|
43
|
+
answers: z.array(z.array(z.string())).optional(),
|
|
44
|
+
createdAt: z.string().min(1),
|
|
45
|
+
updatedAt: z.string().min(1),
|
|
46
|
+
expiresAt: z.string().optional(),
|
|
47
|
+
answeredAt: z.string().optional(),
|
|
48
|
+
cancelledAt: z.string().optional(),
|
|
49
|
+
cancelReason: z.string().optional(),
|
|
50
|
+
answeredBy: z.string().optional(),
|
|
51
|
+
});
|
|
52
|
+
/**
|
|
53
|
+
* Тело ответа на вопрос (`POST` ответа пользователя).
|
|
54
|
+
*
|
|
55
|
+
* Длина `answers` равна числу заданных вопросов, каждая строка — список
|
|
56
|
+
* выбранных значений вариантов. Соответствие длины и непустота обязательных
|
|
57
|
+
* ответов проверяет **сервис** (он знает состав вопроса).
|
|
58
|
+
*/
|
|
59
|
+
export const questionAnswerSchema = z.object({
|
|
60
|
+
answers: z.array(z.array(z.string())),
|
|
61
|
+
});
|
|
62
|
+
/** Тело отмены вопроса (`reason` — свободное пояснение). */
|
|
63
|
+
export const questionCancelSchema = z.object({
|
|
64
|
+
reason: z.string().optional(),
|
|
65
|
+
});
|
|
@@ -10,7 +10,9 @@
|
|
|
10
10
|
* ADR-051/ADR-089: цель срабатывания расписания.
|
|
11
11
|
* - `bound` — постоянная сессия (событие уходит в неё);
|
|
12
12
|
* - `ephemeral` — разовая сессия с TTL и авто-архивом;
|
|
13
|
-
* - `queue` — не запускать сразу, отложить
|
|
13
|
+
* - `queue` — не запускать сразу, отложить владельцу;
|
|
14
|
+
* - `pipeline` — прямой запуск прогона пайплайна (ADR-101): событие в Router
|
|
15
|
+
* **не** публикуется, шедулер запускает прогон сам.
|
|
14
16
|
*/
|
|
15
17
|
export type ScheduleTarget = {
|
|
16
18
|
mode: 'bound';
|
|
@@ -23,6 +25,16 @@ export type ScheduleTarget = {
|
|
|
23
25
|
} | {
|
|
24
26
|
mode: 'queue';
|
|
25
27
|
sessionId: string;
|
|
28
|
+
} | {
|
|
29
|
+
mode: 'pipeline';
|
|
30
|
+
/** Проект-владелец пайплайна (прогон живёт в проекте). */
|
|
31
|
+
projectId: string;
|
|
32
|
+
/** id пайплайна проекта (не шаблона). */
|
|
33
|
+
pipelineId: string;
|
|
34
|
+
/** Версия спецификации; по умолчанию — последняя опубликованная. */
|
|
35
|
+
version?: number;
|
|
36
|
+
/** Данные входа прогона → trigger.payload.* (напр. {sessionId}). */
|
|
37
|
+
payload?: Record<string, unknown>;
|
|
26
38
|
};
|
|
27
39
|
/** ADR-051/ADR-089: статус последнего запуска расписания. */
|
|
28
40
|
export type ScheduleRunStatus = 'ok' | 'error' | 'skipped';
|
|
@@ -39,6 +51,10 @@ export type ScheduleJobTrigger = 'cron' | 'manual' | 'catchup';
|
|
|
39
51
|
* Append-only JSONL `{dataDir}/scheduler/jobs.jsonl`. `decision` — итог
|
|
40
52
|
* маршрутизации события (`RouteDecision['kind']`), `reason` — причина
|
|
41
53
|
* `drop`/`skip`, `sessionId` — материализованная Router'ом сессия (если была).
|
|
54
|
+
*
|
|
55
|
+
* ADR-101: для цели `mode:'pipeline'` событие в Router не публикуется, поэтому
|
|
56
|
+
* `decision:'pipeline'` — **пометка прямого запуска прогона**, а не решение
|
|
57
|
+
* Router; `pipelineId`/`runId` адресуют запущенный прогон.
|
|
42
58
|
*/
|
|
43
59
|
export interface ScheduleJob {
|
|
44
60
|
/** `job_<uuid>`, уникален в пределах инстанса. */
|
|
@@ -55,12 +71,19 @@ export interface ScheduleJob {
|
|
|
55
71
|
target: ScheduleTarget;
|
|
56
72
|
/** Ключ идемпотентности события (`cron:<id>:<...>`). */
|
|
57
73
|
dedupKey?: string;
|
|
58
|
-
/**
|
|
59
|
-
|
|
74
|
+
/**
|
|
75
|
+
* Решение Router: `'bound' | 'queue' | 'ephemeral' | 'bind' | 'drop'`;
|
|
76
|
+
* `'pipeline'` — прямой запуск прогона пайплайна (ADR-101, не решение Router).
|
|
77
|
+
*/
|
|
78
|
+
decision?: 'bound' | 'queue' | 'ephemeral' | 'bind' | 'drop' | 'pipeline';
|
|
60
79
|
/** Причина `drop`/`skip` (напр. `no_route`, `busy`, `missed`). */
|
|
61
80
|
reason?: string;
|
|
62
81
|
/** Идентификатор сессии, в которую доставлено событие. */
|
|
63
82
|
sessionId?: string;
|
|
83
|
+
/** ADR-101: id пайплайна, прогон которого запущен расписанием. */
|
|
84
|
+
pipelineId?: string;
|
|
85
|
+
/** ADR-101: id запущенного прогона пайплайна. */
|
|
86
|
+
runId?: string;
|
|
64
87
|
/** Текст ошибки при `status === 'error'`. */
|
|
65
88
|
error?: string;
|
|
66
89
|
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-023 / ADR-090: минимальный semver-рандж-матчер без внешних
|
|
3
|
+
* зависимостей (инвариант 12 — новые npm-пакеты только с разрешения).
|
|
4
|
+
*
|
|
5
|
+
* Модуль browser-safe (только строки и числа). Канонический источник истины
|
|
6
|
+
* для диапазонов версий host'а и контрактов расширений: и `host`, и
|
|
7
|
+
* `contracts` манифеста `synth.pack` используют один и тот же синтаксис
|
|
8
|
+
* (как `engines` в package.json).
|
|
9
|
+
*
|
|
10
|
+
* Поддерживаемая грамматика (ровно та, что объявляет
|
|
11
|
+
* {@link SEMVER_RANGE_REGEX} — тот же набор, что принимает `packHostSchema`):
|
|
12
|
+
* - оператор: `^`, `~`, `>=`, `<=`, `>`, `<`, `=` — либо отсутствует;
|
|
13
|
+
* - версия: 1–3 компонента (`major`, `major.minor`, `major.minor.patch`),
|
|
14
|
+
* компонент может быть `x`/`X`/`*` (wildcard); версия целиком — `*`/`x`
|
|
15
|
+
* (любая версия);
|
|
16
|
+
* - необязательные пре-релиз/сборка (`-alpha`, `+build`) — **не участвуют** в
|
|
17
|
+
* сравнении (сравниваются только major/minor/patch).
|
|
18
|
+
*
|
|
19
|
+
* Конъюнкция: пробел — «все условия должны выполняться» (`>=1.0.0 <2.0.0`).
|
|
20
|
+
* Дизъюнкция (`||`) **не поддерживается** — её нет и в `PACK_HOST_RANGE_REGEX`,
|
|
21
|
+
* поэтому такой диапазон невалиден (fail-closed).
|
|
22
|
+
*/
|
|
23
|
+
/** Разобранная версия (сравниваются только major/minor/patch). */
|
|
24
|
+
export interface SemverParts {
|
|
25
|
+
major: number;
|
|
26
|
+
minor: number;
|
|
27
|
+
patch: number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Грамматика semver-диапазона. Единый источник истины для проверки формы
|
|
31
|
+
* диапазона (`host` манифеста расширения, значения `contracts`).
|
|
32
|
+
*/
|
|
33
|
+
export declare const SEMVER_RANGE_REGEX: RegExp;
|
|
34
|
+
/**
|
|
35
|
+
* Проверяет, что значение — корректный semver-диапазон (набор условий,
|
|
36
|
+
* разделённых пробелом). Каждая часть должна соответствовать
|
|
37
|
+
* {@link SEMVER_RANGE_REGEX}.
|
|
38
|
+
*/
|
|
39
|
+
export declare function isSemverRange(value: string): boolean;
|
|
40
|
+
/** Разбирает полную semver-версию; `null` — не semver. */
|
|
41
|
+
export declare function parseSemver(version: string): SemverParts | null;
|
|
42
|
+
/**
|
|
43
|
+
* Проверяет, что версия удовлетворяет semver-диапазону.
|
|
44
|
+
*
|
|
45
|
+
* Все условия диапазона (пробел — конъюнкция) должны выполняться. Невалидный
|
|
46
|
+
* диапазон или не-semver версия → `false` (fail-closed).
|
|
47
|
+
*/
|
|
48
|
+
export declare function satisfiesSemverRange(version: string, range: string): boolean;
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-023 / ADR-090: минимальный semver-рандж-матчер без внешних
|
|
3
|
+
* зависимостей (инвариант 12 — новые npm-пакеты только с разрешения).
|
|
4
|
+
*
|
|
5
|
+
* Модуль browser-safe (только строки и числа). Канонический источник истины
|
|
6
|
+
* для диапазонов версий host'а и контрактов расширений: и `host`, и
|
|
7
|
+
* `contracts` манифеста `synth.pack` используют один и тот же синтаксис
|
|
8
|
+
* (как `engines` в package.json).
|
|
9
|
+
*
|
|
10
|
+
* Поддерживаемая грамматика (ровно та, что объявляет
|
|
11
|
+
* {@link SEMVER_RANGE_REGEX} — тот же набор, что принимает `packHostSchema`):
|
|
12
|
+
* - оператор: `^`, `~`, `>=`, `<=`, `>`, `<`, `=` — либо отсутствует;
|
|
13
|
+
* - версия: 1–3 компонента (`major`, `major.minor`, `major.minor.patch`),
|
|
14
|
+
* компонент может быть `x`/`X`/`*` (wildcard); версия целиком — `*`/`x`
|
|
15
|
+
* (любая версия);
|
|
16
|
+
* - необязательные пре-релиз/сборка (`-alpha`, `+build`) — **не участвуют** в
|
|
17
|
+
* сравнении (сравниваются только major/minor/patch).
|
|
18
|
+
*
|
|
19
|
+
* Конъюнкция: пробел — «все условия должны выполняться» (`>=1.0.0 <2.0.0`).
|
|
20
|
+
* Дизъюнкция (`||`) **не поддерживается** — её нет и в `PACK_HOST_RANGE_REGEX`,
|
|
21
|
+
* поэтому такой диапазон невалиден (fail-closed).
|
|
22
|
+
*/
|
|
23
|
+
/**
|
|
24
|
+
* Грамматика semver-диапазона. Единый источник истины для проверки формы
|
|
25
|
+
* диапазона (`host` манифеста расширения, значения `contracts`).
|
|
26
|
+
*/
|
|
27
|
+
export const SEMVER_RANGE_REGEX = /^(?:(?:\^|~|>=|<=|>|<|=)?(?:\d+(?:\.(?:\d+|[xX*])){0,2}|[xX*]))(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
|
|
28
|
+
/** Полный semver (`major.minor.patch` + необязательные пре-релиз/сборка). */
|
|
29
|
+
const SEMVER_VERSION_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
|
|
30
|
+
/**
|
|
31
|
+
* Проверяет, что значение — корректный semver-диапазон (набор условий,
|
|
32
|
+
* разделённых пробелом). Каждая часть должна соответствовать
|
|
33
|
+
* {@link SEMVER_RANGE_REGEX}.
|
|
34
|
+
*/
|
|
35
|
+
export function isSemverRange(value) {
|
|
36
|
+
const parts = value.trim().split(/\s+/).filter(Boolean);
|
|
37
|
+
return parts.length > 0 && parts.every((part) => SEMVER_RANGE_REGEX.test(part));
|
|
38
|
+
}
|
|
39
|
+
/** Разбирает полную semver-версию; `null` — не semver. */
|
|
40
|
+
export function parseSemver(version) {
|
|
41
|
+
const match = SEMVER_VERSION_REGEX.exec(version.trim());
|
|
42
|
+
if (!match)
|
|
43
|
+
return null;
|
|
44
|
+
return {
|
|
45
|
+
major: Number(match[1]),
|
|
46
|
+
minor: Number(match[2]),
|
|
47
|
+
patch: Number(match[3]),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
function parseRangeVersion(raw) {
|
|
51
|
+
const match = SEMVER_RANGE_REGEX.exec(raw.trim());
|
|
52
|
+
if (!match)
|
|
53
|
+
return null;
|
|
54
|
+
// Отрезаем оператор и пре-релиз/сборку — остаются только компоненты.
|
|
55
|
+
const body = raw.trim().replace(/^(?:\^|~|>=|<=|>|<|=)/, '').split(/[-+]/, 1)[0] ?? '';
|
|
56
|
+
const parts = body.split('.');
|
|
57
|
+
const major = Number(parts[0]);
|
|
58
|
+
if (!Number.isFinite(major))
|
|
59
|
+
return null;
|
|
60
|
+
const toComponent = (part) => {
|
|
61
|
+
if (part === undefined)
|
|
62
|
+
return undefined;
|
|
63
|
+
if (part === 'x' || part === 'X' || part === '*')
|
|
64
|
+
return 'x';
|
|
65
|
+
const value = Number(part);
|
|
66
|
+
return Number.isFinite(value) ? value : 'x';
|
|
67
|
+
};
|
|
68
|
+
return {
|
|
69
|
+
major,
|
|
70
|
+
...(parts.length > 1 ? { minor: toComponent(parts[1]) } : {}),
|
|
71
|
+
...(parts.length > 2 ? { patch: toComponent(parts[2]) } : {}),
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
function compare(a, b) {
|
|
75
|
+
if (a.major !== b.major)
|
|
76
|
+
return a.major - b.major;
|
|
77
|
+
if (a.minor !== b.minor)
|
|
78
|
+
return a.minor - b.minor;
|
|
79
|
+
return a.patch - b.patch;
|
|
80
|
+
}
|
|
81
|
+
/** Заполняет отсутствующие компоненты нулями (для нижней границы). */
|
|
82
|
+
function fill(parts) {
|
|
83
|
+
return {
|
|
84
|
+
major: parts.major,
|
|
85
|
+
minor: typeof parts.minor === 'number' ? parts.minor : 0,
|
|
86
|
+
patch: typeof parts.patch === 'number' ? parts.patch : 0,
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Верхняя граница для wildcard-условий: `1.x` → `<2.0.0`, `1.2.x` → `<1.3.0`.
|
|
91
|
+
*/
|
|
92
|
+
function wildcardUpper(parts) {
|
|
93
|
+
if (typeof parts.minor !== 'number')
|
|
94
|
+
return { major: parts.major + 1, minor: 0, patch: 0 };
|
|
95
|
+
if (typeof parts.patch !== 'number')
|
|
96
|
+
return { major: parts.major, minor: parts.minor + 1, patch: 0 };
|
|
97
|
+
// patch задан — wildcard только в patch не трактуется (верхняя граница = сама версия).
|
|
98
|
+
return fill(parts);
|
|
99
|
+
}
|
|
100
|
+
function boundsFor(raw) {
|
|
101
|
+
const trimmed = raw.trim();
|
|
102
|
+
const opMatch = /^(\^|~|>=|<=|>|<|=)/.exec(trimmed);
|
|
103
|
+
const op = opMatch?.[1] ?? '=';
|
|
104
|
+
// Wildcard-only (`*`/`x`): диапазон не ограничивает версию (любой оператор).
|
|
105
|
+
const body = trimmed.replace(/^(?:\^|~|>=|<=|>|<|=)/, '').split(/[-+]/, 1)[0] ?? '';
|
|
106
|
+
if (body === '*' || body === 'x' || body === 'X')
|
|
107
|
+
return {};
|
|
108
|
+
const version = parseRangeVersion(trimmed);
|
|
109
|
+
if (!version)
|
|
110
|
+
return null;
|
|
111
|
+
const lower = fill(version);
|
|
112
|
+
const hasWildcardMinor = version.minor === 'x' || version.minor === undefined;
|
|
113
|
+
const hasWildcardPatch = version.patch === 'x' || version.patch === undefined;
|
|
114
|
+
switch (op) {
|
|
115
|
+
case '^': {
|
|
116
|
+
// Caret: мажор фиксирован, минор/патч — только если мажор 0.
|
|
117
|
+
if (version.major > 0) {
|
|
118
|
+
return { lower, lowerInclusive: true, upper: { major: version.major + 1, minor: 0, patch: 0 }, upperInclusive: false };
|
|
119
|
+
}
|
|
120
|
+
if (typeof version.minor === 'number' && version.minor > 0) {
|
|
121
|
+
return { lower, lowerInclusive: true, upper: { major: 0, minor: version.minor + 1, patch: 0 }, upperInclusive: false };
|
|
122
|
+
}
|
|
123
|
+
if (typeof version.minor === 'number' && typeof version.patch === 'number') {
|
|
124
|
+
return { lower, lowerInclusive: true, upper: { major: 0, minor: 0, patch: version.patch + 1 }, upperInclusive: false };
|
|
125
|
+
}
|
|
126
|
+
// `^0` / `^0.x` — весь нулевой мажор.
|
|
127
|
+
return { lower, lowerInclusive: true, upper: { major: 1, minor: 0, patch: 0 }, upperInclusive: false };
|
|
128
|
+
}
|
|
129
|
+
case '~': {
|
|
130
|
+
if (typeof version.minor === 'number') {
|
|
131
|
+
return { lower, lowerInclusive: true, upper: { major: version.major, minor: version.minor + 1, patch: 0 }, upperInclusive: false };
|
|
132
|
+
}
|
|
133
|
+
return { lower, lowerInclusive: true, upper: { major: version.major + 1, minor: 0, patch: 0 }, upperInclusive: false };
|
|
134
|
+
}
|
|
135
|
+
case '>=': {
|
|
136
|
+
if (hasWildcardMinor)
|
|
137
|
+
return { lower: { major: version.major, minor: 0, patch: 0 }, lowerInclusive: true };
|
|
138
|
+
return { lower, lowerInclusive: true };
|
|
139
|
+
}
|
|
140
|
+
case '>': {
|
|
141
|
+
if (hasWildcardMinor) {
|
|
142
|
+
return { lower: { major: version.major + 1, minor: 0, patch: 0 }, lowerInclusive: true };
|
|
143
|
+
}
|
|
144
|
+
if (hasWildcardPatch) {
|
|
145
|
+
return { lower: { major: version.major, minor: version.minor + 1, patch: 0 }, lowerInclusive: true };
|
|
146
|
+
}
|
|
147
|
+
return { lower, lowerInclusive: false };
|
|
148
|
+
}
|
|
149
|
+
case '<=': {
|
|
150
|
+
if (hasWildcardMinor) {
|
|
151
|
+
return { upper: { major: version.major + 1, minor: 0, patch: 0 }, upperInclusive: false };
|
|
152
|
+
}
|
|
153
|
+
if (hasWildcardPatch) {
|
|
154
|
+
return { upper: { major: version.major, minor: version.minor + 1, patch: 0 }, upperInclusive: false };
|
|
155
|
+
}
|
|
156
|
+
return { upper: lower, upperInclusive: true };
|
|
157
|
+
}
|
|
158
|
+
case '<': {
|
|
159
|
+
if (hasWildcardMinor) {
|
|
160
|
+
return { upper: { major: version.major, minor: 0, patch: 0 }, upperInclusive: false };
|
|
161
|
+
}
|
|
162
|
+
if (hasWildcardPatch) {
|
|
163
|
+
return { upper: { major: version.major, minor: version.minor, patch: 0 }, upperInclusive: false };
|
|
164
|
+
}
|
|
165
|
+
return { upper: lower, upperInclusive: false };
|
|
166
|
+
}
|
|
167
|
+
case '=':
|
|
168
|
+
default: {
|
|
169
|
+
// Точное совпадение; wildcard-компоненты не ограничивают.
|
|
170
|
+
if (hasWildcardMinor) {
|
|
171
|
+
return { lower: { major: version.major, minor: 0, patch: 0 }, lowerInclusive: true, upper: wildcardUpper(version), upperInclusive: false };
|
|
172
|
+
}
|
|
173
|
+
if (hasWildcardPatch) {
|
|
174
|
+
return { lower: { major: version.major, minor: version.minor, patch: 0 }, lowerInclusive: true, upper: wildcardUpper(version), upperInclusive: false };
|
|
175
|
+
}
|
|
176
|
+
return { lower, lowerInclusive: true, upper: lower, upperInclusive: true };
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
function withinBounds(version, bounds) {
|
|
181
|
+
if (bounds.lower) {
|
|
182
|
+
const cmp = compare(version, bounds.lower);
|
|
183
|
+
if (cmp < 0)
|
|
184
|
+
return false;
|
|
185
|
+
if (cmp === 0 && !bounds.lowerInclusive)
|
|
186
|
+
return false;
|
|
187
|
+
}
|
|
188
|
+
if (bounds.upper) {
|
|
189
|
+
const cmp = compare(version, bounds.upper);
|
|
190
|
+
if (cmp > 0)
|
|
191
|
+
return false;
|
|
192
|
+
if (cmp === 0 && !bounds.upperInclusive)
|
|
193
|
+
return false;
|
|
194
|
+
}
|
|
195
|
+
return true;
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
* Проверяет, что версия удовлетворяет semver-диапазону.
|
|
199
|
+
*
|
|
200
|
+
* Все условия диапазона (пробел — конъюнкция) должны выполняться. Невалидный
|
|
201
|
+
* диапазон или не-semver версия → `false` (fail-closed).
|
|
202
|
+
*/
|
|
203
|
+
export function satisfiesSemverRange(version, range) {
|
|
204
|
+
const parsed = parseSemver(version);
|
|
205
|
+
if (!parsed)
|
|
206
|
+
return false;
|
|
207
|
+
const conditions = range.trim().split(/\s+/).filter(Boolean);
|
|
208
|
+
if (conditions.length === 0)
|
|
209
|
+
return false;
|
|
210
|
+
for (const condition of conditions) {
|
|
211
|
+
const bounds = boundsFor(condition);
|
|
212
|
+
if (!bounds)
|
|
213
|
+
return false;
|
|
214
|
+
if (!withinBounds(parsed, bounds))
|
|
215
|
+
return false;
|
|
216
|
+
}
|
|
217
|
+
return true;
|
|
218
|
+
}
|
|
@@ -8,6 +8,11 @@ import type { GlobalRole } from './index.js';
|
|
|
8
8
|
/**
|
|
9
9
|
* Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
|
|
10
10
|
* (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
|
|
11
|
+
*
|
|
12
|
+
* `automation` в семейства **не** входит: `automation:install` — зонтичный скоуп
|
|
13
|
+
* установки пакета расширений, а не ресурсное семейство. Wildcard `automation:*`
|
|
14
|
+
* не вводится намеренно — иначе он молча покрывал бы будущие `automation:*`-скоупы
|
|
15
|
+
* (напр. запуск/удаление), не связанные с установкой пакета.
|
|
11
16
|
*/
|
|
12
17
|
export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules"];
|
|
13
18
|
export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
|
|
@@ -16,12 +21,39 @@ export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
|
|
|
16
21
|
* Точечные скоупы вне wildcard-семейств:
|
|
17
22
|
* - `llm:chat` — LLM-прокси (роут без проектного измерения);
|
|
18
23
|
* - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
|
|
19
|
-
* MCP-реестра и скиллов (
|
|
24
|
+
* MCP-реестра и скиллов (ADR-090 installer);
|
|
25
|
+
* - `automation:install` — зонтичный скоуп **установщика пакетов расширений**:
|
|
26
|
+
* агенты и их ролевые промпты, пайплайны, а также порождаемые пакетом
|
|
27
|
+
* правила маршрутизации и расписания. Для установщика пакета заменяет
|
|
28
|
+
* `addons:install`, `routes:write` и `schedules:write` (см. `SERVICE_SCOPE_SETS`);
|
|
29
|
+
* `addons:install` при этом **не** открывает создание агентов;
|
|
20
30
|
* - `users:read` — чтение пользователей/идентичностей машинной кредой
|
|
21
|
-
* (консент-сервисы аддонов)
|
|
31
|
+
* (консент-сервисы аддонов);
|
|
32
|
+
* - `plugins:invoke` — server-scoped токен плагина (ADR-090 Ф7, Уровень 2):
|
|
33
|
+
* ключ, привязанный к `plugin_id`; без этого scope сервер отвергает такой
|
|
34
|
+
* ключ (fail-closed).
|
|
22
35
|
*/
|
|
23
|
-
export declare const SERVICE_SCOPES: readonly ["events:ingest", "events:watch", "bindings:read", "bindings:write", "keys:read", "keys:write", "routes:read", "routes:write", "sessions:create", "sessions:read", "sessions:prompt", "schedules:read", "schedules:write", "llm:chat", "addons:install", "users:read"];
|
|
36
|
+
export declare const SERVICE_SCOPES: readonly ["events:ingest", "events:watch", "bindings:read", "bindings:write", "keys:read", "keys:write", "routes:read", "routes:write", "sessions:create", "sessions:read", "sessions:prompt", "schedules:read", "schedules:write", "llm:chat", "addons:install", "automation:install", "users:read", "plugins:invoke"];
|
|
24
37
|
export type ServiceScope = (typeof SERVICE_SCOPES)[number];
|
|
38
|
+
/**
|
|
39
|
+
* ADR-052: «любой из»-наборы скоупов для гейтов, где зонтичный
|
|
40
|
+
* `automation:install` (установщик пакета) заменяет ресурсный скоуп.
|
|
41
|
+
*
|
|
42
|
+
* Это единственное место, где выражено «замещение»: guard проверяет, что
|
|
43
|
+
* покрыт **хотя бы один** элемент набора. `routes:write`/`schedules:write`
|
|
44
|
+
* остаются самостоятельными (правка чужих правил/расписаний), а
|
|
45
|
+
* `automation:install` — доступ установщика пакета к тем же точкам.
|
|
46
|
+
*/
|
|
47
|
+
export declare const SERVICE_SCOPE_SETS: {
|
|
48
|
+
/** Запись правил маршрутизации: `routes:write` или установщик пакета. */
|
|
49
|
+
readonly routesWrite: readonly ["routes:write", "automation:install"];
|
|
50
|
+
/** Запись расписаний: `schedules:write` или установщик пакета. */
|
|
51
|
+
readonly schedulesWrite: readonly ["schedules:write", "automation:install"];
|
|
52
|
+
/** Установка агентов и их ролевых промптов: установщик пакета. */
|
|
53
|
+
readonly agentsWrite: readonly ["automation:install"];
|
|
54
|
+
};
|
|
55
|
+
/** Набор скоупов «достаточно любого из» (см. `SERVICE_SCOPE_SETS`). */
|
|
56
|
+
export type ServiceScopeSet = (typeof SERVICE_SCOPE_SETS)[keyof typeof SERVICE_SCOPE_SETS];
|
|
25
57
|
/**
|
|
26
58
|
* `true`, если строка — известный скоуп: элемент каталога либо wildcard
|
|
27
59
|
* семейства (`<family>:*`, напр. `events:*`). Глобальный `*` не принимается.
|
|
@@ -36,6 +68,12 @@ export declare function isKnownScope(scope: string): boolean;
|
|
|
36
68
|
* Глобальный `*` не поддерживается: `hasServiceScope(granted, '*')` → `false`.
|
|
37
69
|
*/
|
|
38
70
|
export declare function hasServiceScope(granted: readonly string[], required: string): boolean;
|
|
71
|
+
/**
|
|
72
|
+
* Проверка «достаточно любого из»: покрыт **хотя бы один** элемент `required`
|
|
73
|
+
* (точное совпадение или wildcard-семейство, `hasServiceScope`). Пустой
|
|
74
|
+
* `required` ничего не открывает (fail-closed).
|
|
75
|
+
*/
|
|
76
|
+
export declare function hasAnyServiceScope(granted: readonly string[], required: readonly string[]): boolean;
|
|
39
77
|
/**
|
|
40
78
|
* ADR-052: service-key инстанса.
|
|
41
79
|
*
|