@itphx/synth-shared 0.9.0 → 0.10.1
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 +51 -1
- package/dist/config/env-overrides.d.ts +68 -0
- package/dist/config/env-overrides.js +165 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/loader.d.ts +3 -1
- package/dist/config/loader.js +12 -4
- package/dist/config/resolve.d.ts +23 -6
- package/dist/config/resolve.js +33 -12
- package/dist/config/types.d.ts +699 -146
- package/dist/config/types.js +195 -28
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +50 -8
- package/dist/index.d.ts +4 -2
- package/dist/index.js +3 -2
- package/dist/interfaces/index.d.ts +8 -1
- package/dist/schemas/index.d.ts +1723 -45
- package/dist/schemas/index.js +403 -29
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +502 -0
- package/dist/types/decision.js +98 -0
- package/dist/types/events.d.ts +219 -0
- package/dist/types/events.js +1 -0
- package/dist/types/fs.d.ts +44 -0
- package/dist/types/fs.js +16 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +96 -0
- package/dist/types/hooks.js +1 -0
- package/dist/types/index.d.ts +18 -1097
- package/dist/types/index.js +44 -215
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/mcp.d.ts +104 -0
- package/dist/types/mcp.js +40 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +2 -2
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +236 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +109 -0
- package/dist/types/schedules.js +9 -0
- package/dist/types/service-keys.d.ts +106 -0
- package/dist/types/service-keys.js +72 -0
- package/dist/types/session.d.ts +269 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +4 -3
- package/dist/types/tools.js +2 -0
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +97 -0
- package/dist/types/webhooks.js +53 -0
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.js +2 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-051 (минимальный срез) / ADR-089: контракты планировщика расписаний.
|
|
3
|
+
*
|
|
4
|
+
* Шедулер не создаёт сессии сам: срабатывание публикует нормализованное событие
|
|
5
|
+
* (`source: 'cron'`, `type: 'schedule_fired'`) через `EventIngress`, а
|
|
6
|
+
* маршрутизацию в сессию выполняет `EventRouter` (seam — `RouteRuleProvider`).
|
|
7
|
+
* Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
|
|
8
|
+
*/
|
|
9
|
+
/**
|
|
10
|
+
* ADR-051/ADR-089: цель срабатывания расписания.
|
|
11
|
+
* - `bound` — постоянная сессия (событие уходит в неё);
|
|
12
|
+
* - `ephemeral` — разовая сессия с TTL и авто-архивом;
|
|
13
|
+
* - `queue` — не запускать сразу, отложить владельцу.
|
|
14
|
+
*/
|
|
15
|
+
export type ScheduleTarget = {
|
|
16
|
+
mode: 'bound';
|
|
17
|
+
sessionId: string;
|
|
18
|
+
} | {
|
|
19
|
+
mode: 'ephemeral';
|
|
20
|
+
agentTemplate?: string;
|
|
21
|
+
project?: string;
|
|
22
|
+
ttl?: string;
|
|
23
|
+
} | {
|
|
24
|
+
mode: 'queue';
|
|
25
|
+
sessionId: string;
|
|
26
|
+
};
|
|
27
|
+
/** ADR-051/ADR-089: статус последнего запуска расписания. */
|
|
28
|
+
export type ScheduleRunStatus = 'ok' | 'error' | 'skipped';
|
|
29
|
+
/**
|
|
30
|
+
* ADR-051: триггер срабатывания расписания.
|
|
31
|
+
* - `cron` — обычный тик планировщика (или интервальное срабатывание);
|
|
32
|
+
* - `manual` — принудительный запуск (`POST /:id/run`, force);
|
|
33
|
+
* - `catchup` — догоняющее срабатывание после простоя.
|
|
34
|
+
*/
|
|
35
|
+
export type ScheduleJobTrigger = 'cron' | 'manual' | 'catchup';
|
|
36
|
+
/**
|
|
37
|
+
* ADR-051: запись Job-истории — результат одного срабатывания расписания.
|
|
38
|
+
*
|
|
39
|
+
* Append-only JSONL `{dataDir}/scheduler/jobs.jsonl`. `decision` — итог
|
|
40
|
+
* маршрутизации события (`RouteDecision['kind']`), `reason` — причина
|
|
41
|
+
* `drop`/`skip`, `sessionId` — материализованная Router'ом сессия (если была).
|
|
42
|
+
*/
|
|
43
|
+
export interface ScheduleJob {
|
|
44
|
+
/** `job_<uuid>`, уникален в пределах инстанса. */
|
|
45
|
+
id: string;
|
|
46
|
+
scheduleId: string;
|
|
47
|
+
scheduleName: string;
|
|
48
|
+
trigger: ScheduleJobTrigger;
|
|
49
|
+
status: ScheduleRunStatus;
|
|
50
|
+
/** Начало срабатывания, ISO-8601. */
|
|
51
|
+
startedAt: string;
|
|
52
|
+
/** Окончание срабатывания, ISO-8601. */
|
|
53
|
+
finishedAt: string;
|
|
54
|
+
durationMs: number;
|
|
55
|
+
target: ScheduleTarget;
|
|
56
|
+
/** Ключ идемпотентности события (`cron:<id>:<...>`). */
|
|
57
|
+
dedupKey?: string;
|
|
58
|
+
/** Решение Router: `'bound' | 'queue' | 'ephemeral' | 'bind' | 'drop'`. */
|
|
59
|
+
decision?: 'bound' | 'queue' | 'ephemeral' | 'bind' | 'drop';
|
|
60
|
+
/** Причина `drop`/`skip` (напр. `no_route`, `busy`, `missed`). */
|
|
61
|
+
reason?: string;
|
|
62
|
+
/** Идентификатор сессии, в которую доставлено событие. */
|
|
63
|
+
sessionId?: string;
|
|
64
|
+
/** Текст ошибки при `status === 'error'`. */
|
|
65
|
+
error?: string;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* ADR-051/ADR-089: расписание запуска промпта/события.
|
|
69
|
+
*
|
|
70
|
+
* Ровно одно из `cron` (5 полей) / `every` (интервал) задано; время cron
|
|
71
|
+
* считается в UTC. `payload` домешивается в тело события, `prompt` — текст
|
|
72
|
+
* сообщения (`payload.text`).
|
|
73
|
+
*/
|
|
74
|
+
export interface Schedule {
|
|
75
|
+
/** `sch_<uuid>`, уникален в пределах инстанса. */
|
|
76
|
+
id: string;
|
|
77
|
+
name: string;
|
|
78
|
+
enabled: boolean;
|
|
79
|
+
/** Cron-выражение из 5 полей (`minute hour day-of-month month day-of-week`), UTC. */
|
|
80
|
+
cron?: string;
|
|
81
|
+
/** Интервал `30s | 15m | 1h | 24h`. */
|
|
82
|
+
every?: string;
|
|
83
|
+
target: ScheduleTarget;
|
|
84
|
+
/** Текст промпта (попадает в событие как `payload.text`). */
|
|
85
|
+
prompt?: string;
|
|
86
|
+
/** Дополнительные поля тела события. */
|
|
87
|
+
payload?: Record<string, unknown>;
|
|
88
|
+
/** Владелец расписания (попадает в `identity.principalId`). */
|
|
89
|
+
ownerId?: string;
|
|
90
|
+
/**
|
|
91
|
+
* ADR-051: поведение при пропущенном срабатывании на старте процесса
|
|
92
|
+
* (`skip` — пропустить, `once` — одно догоняющее). Не задано — дефолт из
|
|
93
|
+
* конфига `scheduler.catchUp`.
|
|
94
|
+
*/
|
|
95
|
+
catchUp?: 'skip' | 'once';
|
|
96
|
+
createdAt: string;
|
|
97
|
+
updatedAt: string;
|
|
98
|
+
/** Время последнего запуска, ISO-8601. */
|
|
99
|
+
lastRunAt?: string;
|
|
100
|
+
/** Время следующего запуска, ISO-8601. */
|
|
101
|
+
nextRunAt?: string;
|
|
102
|
+
lastStatus?: ScheduleRunStatus;
|
|
103
|
+
lastError?: string;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* ADR-051/ADR-089: вход создания/обновления расписания — без служебных полей,
|
|
107
|
+
* которыми управляет хранилище/сервис (`id`, таймстемпы, статус последнего запуска).
|
|
108
|
+
*/
|
|
109
|
+
export type ScheduleInput = Omit<Schedule, 'id' | 'createdAt' | 'updatedAt' | 'lastRunAt' | 'nextRunAt' | 'lastStatus' | 'lastError'>;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-051 (минимальный срез) / ADR-089: контракты планировщика расписаний.
|
|
3
|
+
*
|
|
4
|
+
* Шедулер не создаёт сессии сам: срабатывание публикует нормализованное событие
|
|
5
|
+
* (`source: 'cron'`, `type: 'schedule_fired'`) через `EventIngress`, а
|
|
6
|
+
* маршрутизацию в сессию выполняет `EventRouter` (seam — `RouteRuleProvider`).
|
|
7
|
+
* Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
|
|
8
|
+
*/
|
|
9
|
+
export {};
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-052 (этап I): service-key — независимый от binding-key (ADR-089) ключ
|
|
3
|
+
* инстанса для внешних сервисов со **скоупами** (`scopes`) и **проектной
|
|
4
|
+
* проекцией** (`allowedProjects`). Здесь только контракты и browser-safe
|
|
5
|
+
* матчер скоупов; хранилище и enforcement живут в core.
|
|
6
|
+
*/
|
|
7
|
+
import type { GlobalRole } from './index.js';
|
|
8
|
+
/**
|
|
9
|
+
* Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
|
|
10
|
+
* (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
|
|
11
|
+
*/
|
|
12
|
+
export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules"];
|
|
13
|
+
export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
|
|
14
|
+
/**
|
|
15
|
+
* Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
|
|
16
|
+
* Точечные скоупы вне wildcard-семейств:
|
|
17
|
+
* - `llm:chat` — LLM-прокси (роут без проектного измерения);
|
|
18
|
+
* - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
|
|
19
|
+
* MCP-реестра и скиллов (PROP-090 installer);
|
|
20
|
+
* - `users:read` — чтение пользователей/идентичностей машинной кредой
|
|
21
|
+
* (консент-сервисы аддонов).
|
|
22
|
+
*/
|
|
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"];
|
|
24
|
+
export type ServiceScope = (typeof SERVICE_SCOPES)[number];
|
|
25
|
+
/**
|
|
26
|
+
* `true`, если строка — известный скоуп: элемент каталога либо wildcard
|
|
27
|
+
* семейства (`<family>:*`, напр. `events:*`). Глобальный `*` не принимается.
|
|
28
|
+
*/
|
|
29
|
+
export declare function isKnownScope(scope: string): boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Проверка покрытия требуемого скоупа выданными:
|
|
32
|
+
* - точное совпадение (`events:ingest` ∈ granted);
|
|
33
|
+
* - wildcard-семейство (`events:*` покрывает любой `events:<x>`);
|
|
34
|
+
* - для запроса `family:*` — только тот же wildcard (не покрывается точными).
|
|
35
|
+
*
|
|
36
|
+
* Глобальный `*` не поддерживается: `hasServiceScope(granted, '*')` → `false`.
|
|
37
|
+
*/
|
|
38
|
+
export declare function hasServiceScope(granted: readonly string[], required: string): boolean;
|
|
39
|
+
/**
|
|
40
|
+
* ADR-052: service-key инстанса.
|
|
41
|
+
*
|
|
42
|
+
* Секрет (`synth_svc_<base64url>`) не хранится в этой сущности: at-rest лежит
|
|
43
|
+
* только sha256-хеш (внутренняя запись хранилища), наружу отдаётся `prefix`.
|
|
44
|
+
* Полный plaintext — единственный раз в `ServiceApiKeyCreated` при создании.
|
|
45
|
+
*/
|
|
46
|
+
export interface ServiceApiKey {
|
|
47
|
+
/** `svk_<uuid>`. */
|
|
48
|
+
id: string;
|
|
49
|
+
/** Обязательная метка (уникальна глобально по инстансу, регистронезависимо). */
|
|
50
|
+
label: string;
|
|
51
|
+
description?: string;
|
|
52
|
+
/**
|
|
53
|
+
* Роли синтетического пользователя, которому аутентифицирует ключ (RBAC
|
|
54
|
+
* managed-режима / доступность эндпоинтов).
|
|
55
|
+
*/
|
|
56
|
+
roles: GlobalRole[];
|
|
57
|
+
/** Выданные скоупы (каталог + wildcard-семейства; ADR-052, `docs/API_V2.md` §1). */
|
|
58
|
+
scopes: string[];
|
|
59
|
+
/**
|
|
60
|
+
* Проектная проекция: ключ ограничен подмножеством проектов инстанса
|
|
61
|
+
* (ADR-014). Пусто/отсутствует — ключ действует по политике инстанса.
|
|
62
|
+
*/
|
|
63
|
+
allowedProjects?: string[];
|
|
64
|
+
/** Лимит запросов/мин (0 — без лимита); не задан — без лимита. */
|
|
65
|
+
rateLimitPerMinute?: number;
|
|
66
|
+
/** ISO-8601 срок действия; заполнен и прошёл — ключ недействителен. */
|
|
67
|
+
expiresAt?: string;
|
|
68
|
+
/** ISO-8601 мягкий отзыв; заполнен — ключ недействителен независимо от срока. */
|
|
69
|
+
revokedAt?: string;
|
|
70
|
+
/** id создателя. */
|
|
71
|
+
createdBy: string;
|
|
72
|
+
/** ISO-8601. */
|
|
73
|
+
createdAt: string;
|
|
74
|
+
/** ISO-8601; best-effort отметка использования. */
|
|
75
|
+
lastUsedAt?: string;
|
|
76
|
+
/** Префикс секрета для идентификации в UI (plaintext наружу не отдаётся). */
|
|
77
|
+
prefix: string;
|
|
78
|
+
}
|
|
79
|
+
/** ADR-052: ответ создания service-key — метаданные + однократно показываемый секрет. */
|
|
80
|
+
export interface ServiceApiKeyCreated extends ServiceApiKey {
|
|
81
|
+
/** Plaintext-секрет `synth_svc_<base64url>`; возвращается единственный раз. */
|
|
82
|
+
key: string;
|
|
83
|
+
}
|
|
84
|
+
/** ADR-052: тело создания service-key (`POST /api/v2/service-keys`). */
|
|
85
|
+
export interface CreateServiceApiKeyInput {
|
|
86
|
+
label: string;
|
|
87
|
+
description?: string;
|
|
88
|
+
roles?: GlobalRole[];
|
|
89
|
+
scopes: string[];
|
|
90
|
+
allowedProjects?: string[];
|
|
91
|
+
rateLimitPerMinute?: number;
|
|
92
|
+
expiresAt?: string;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* ADR-052: тело обновления service-key (`PATCH /api/v2/service-keys/:id`).
|
|
96
|
+
* `undefined` — не трогать; `null` — сбросить опциональное значение.
|
|
97
|
+
*/
|
|
98
|
+
export interface UpdateServiceApiKeyPatch {
|
|
99
|
+
label?: string;
|
|
100
|
+
description?: string | null;
|
|
101
|
+
roles?: GlobalRole[];
|
|
102
|
+
scopes?: string[];
|
|
103
|
+
allowedProjects?: string[] | null;
|
|
104
|
+
rateLimitPerMinute?: number | null;
|
|
105
|
+
expiresAt?: string | null;
|
|
106
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
|
|
3
|
+
* (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
|
|
4
|
+
*/
|
|
5
|
+
export const SERVICE_SCOPE_FAMILIES = [
|
|
6
|
+
'events',
|
|
7
|
+
'bindings',
|
|
8
|
+
'keys',
|
|
9
|
+
'routes',
|
|
10
|
+
'sessions',
|
|
11
|
+
'schedules',
|
|
12
|
+
];
|
|
13
|
+
/**
|
|
14
|
+
* Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
|
|
15
|
+
* Точечные скоупы вне wildcard-семейств:
|
|
16
|
+
* - `llm:chat` — LLM-прокси (роут без проектного измерения);
|
|
17
|
+
* - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
|
|
18
|
+
* MCP-реестра и скиллов (PROP-090 installer);
|
|
19
|
+
* - `users:read` — чтение пользователей/идентичностей машинной кредой
|
|
20
|
+
* (консент-сервисы аддонов).
|
|
21
|
+
*/
|
|
22
|
+
export const SERVICE_SCOPES = [
|
|
23
|
+
'events:ingest',
|
|
24
|
+
'events:watch',
|
|
25
|
+
'bindings:read',
|
|
26
|
+
'bindings:write',
|
|
27
|
+
'keys:read',
|
|
28
|
+
'keys:write',
|
|
29
|
+
'routes:read',
|
|
30
|
+
'routes:write',
|
|
31
|
+
'sessions:create',
|
|
32
|
+
'sessions:read',
|
|
33
|
+
'sessions:prompt',
|
|
34
|
+
'schedules:read',
|
|
35
|
+
'schedules:write',
|
|
36
|
+
'llm:chat',
|
|
37
|
+
'addons:install',
|
|
38
|
+
'users:read',
|
|
39
|
+
];
|
|
40
|
+
/**
|
|
41
|
+
* `true`, если строка — известный скоуп: элемент каталога либо wildcard
|
|
42
|
+
* семейства (`<family>:*`, напр. `events:*`). Глобальный `*` не принимается.
|
|
43
|
+
*/
|
|
44
|
+
export function isKnownScope(scope) {
|
|
45
|
+
if (SERVICE_SCOPES.includes(scope))
|
|
46
|
+
return true;
|
|
47
|
+
const idx = scope.indexOf(':');
|
|
48
|
+
if (idx <= 0 || idx === scope.length - 1)
|
|
49
|
+
return false;
|
|
50
|
+
const family = scope.slice(0, idx);
|
|
51
|
+
const rest = scope.slice(idx + 1);
|
|
52
|
+
return rest === '*' && SERVICE_SCOPE_FAMILIES.includes(family);
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Проверка покрытия требуемого скоупа выданными:
|
|
56
|
+
* - точное совпадение (`events:ingest` ∈ granted);
|
|
57
|
+
* - wildcard-семейство (`events:*` покрывает любой `events:<x>`);
|
|
58
|
+
* - для запроса `family:*` — только тот же wildcard (не покрывается точными).
|
|
59
|
+
*
|
|
60
|
+
* Глобальный `*` не поддерживается: `hasServiceScope(granted, '*')` → `false`.
|
|
61
|
+
*/
|
|
62
|
+
export function hasServiceScope(granted, required) {
|
|
63
|
+
if (!Array.isArray(granted))
|
|
64
|
+
return false;
|
|
65
|
+
if (granted.includes(required))
|
|
66
|
+
return true;
|
|
67
|
+
const idx = required.indexOf(':');
|
|
68
|
+
if (idx <= 0 || idx === required.length - 1)
|
|
69
|
+
return false;
|
|
70
|
+
const family = required.slice(0, idx);
|
|
71
|
+
return granted.includes(`${family}:*`);
|
|
72
|
+
}
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
import type { PermissionConfig, McpServerToolSettings } from './permission.js';
|
|
2
|
+
import type { Message } from './message.js';
|
|
3
|
+
import type { PromptState } from './prompt.js';
|
|
4
|
+
export type SessionOrigin = 'user' | 'fork' | 'subagent';
|
|
5
|
+
export interface SessionStatus {
|
|
6
|
+
blocked?: string;
|
|
7
|
+
blockedAt?: string;
|
|
8
|
+
/**
|
|
9
|
+
* Персистентный флаг запроса отмены генерации (кнопка «Стоп», `/stop`).
|
|
10
|
+
* Живёт в JSON-хранилище (ADR-005): позволяет остановить сессию, когда
|
|
11
|
+
* `currentStream`/cancel-token ещё не установлены (очередь, backoff).
|
|
12
|
+
* Сбрасывается процессором очереди после обработки.
|
|
13
|
+
*/
|
|
14
|
+
cancelRequested?: boolean;
|
|
15
|
+
/** Время запроса отмены (ISO) — для диагностики/аудита. */
|
|
16
|
+
cancelRequestedAt?: string;
|
|
17
|
+
}
|
|
18
|
+
export declare const PLAN_MODES: readonly ["auto", "strict", "off"];
|
|
19
|
+
export type PlanMode = (typeof PLAN_MODES)[number];
|
|
20
|
+
export declare const SESSION_MODES: readonly ["plan", "act", "yolo"];
|
|
21
|
+
export type SessionMode = (typeof SESSION_MODES)[number];
|
|
22
|
+
/**
|
|
23
|
+
* ADR-071 §2.3: политика включения инструментов в запрос.
|
|
24
|
+
* - `consistency` — в запрос идут все определения, недоступность кодируется
|
|
25
|
+
* permission-слоем (`unavailable(mode|role)`); приоритет — валидность кэша;
|
|
26
|
+
* - `available` — в запрос идут только доступные агенту/режиму/роли тулы;
|
|
27
|
+
* приоритет — экономия контекстного окна;
|
|
28
|
+
* - `auto` — выбор по провайдеру/модели: локальные → `available`, облачные → `consistency`.
|
|
29
|
+
*/
|
|
30
|
+
export declare const TOOLS_POLICIES: readonly ["consistency", "available", "auto"];
|
|
31
|
+
export type ToolsPolicy = (typeof TOOLS_POLICIES)[number];
|
|
32
|
+
export declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
|
|
33
|
+
export type TodoStatus = (typeof TODO_STATUSES)[number];
|
|
34
|
+
export declare const TODO_PRIORITIES: readonly ["high", "medium", "low"];
|
|
35
|
+
export type TodoPriority = (typeof TODO_PRIORITIES)[number];
|
|
36
|
+
export interface TodoItem {
|
|
37
|
+
id: string;
|
|
38
|
+
content: string;
|
|
39
|
+
status: TodoStatus;
|
|
40
|
+
priority: TodoPriority;
|
|
41
|
+
/** Связь с пунктом плана проекта (ADR-039). */
|
|
42
|
+
planItemId?: string;
|
|
43
|
+
}
|
|
44
|
+
export type ReasoningLevel = 'default' | 'none' | 'low' | 'medium' | 'high';
|
|
45
|
+
export interface SessionSettings {
|
|
46
|
+
provider?: string;
|
|
47
|
+
model?: string;
|
|
48
|
+
/** Уровень размышлений модели. Для openai/generic — reasoning_effort, anthropic — thinking, ollama — think. */
|
|
49
|
+
reasoningLevel?: ReasoningLevel;
|
|
50
|
+
temperature: number;
|
|
51
|
+
maxTokens: number;
|
|
52
|
+
systemPrompt?: string;
|
|
53
|
+
debugEnabled: boolean;
|
|
54
|
+
streamEnabled: boolean;
|
|
55
|
+
agentRole?: string;
|
|
56
|
+
/** ADR-071 §2.4: явно включённые в сессии серверы (session level). */
|
|
57
|
+
mcpServers?: string[];
|
|
58
|
+
/**
|
|
59
|
+
* ADR-071 §2.4: явные opt-out серверы сессии (включая системные). Вычитаются
|
|
60
|
+
* из эффективного набора (`(seed ∪ enabled) − disabled`).
|
|
61
|
+
*/
|
|
62
|
+
mcpDisabledServers?: string[];
|
|
63
|
+
/**
|
|
64
|
+
* ADR-071 §2.4: СНАПШОТ MCP-серверов «по умолчанию» на момент создания сессии
|
|
65
|
+
* (снимок `project.defaultOn` либо системного дефолта `enabledByDefault`).
|
|
66
|
+
* Изменение дефолта проекта/системы не влияет на существующие сессии.
|
|
67
|
+
*/
|
|
68
|
+
mcpDefaultOn?: string[];
|
|
69
|
+
contextOptimization: 'none' | 'sliding_window' | 'summarization' | 'sticky_notes';
|
|
70
|
+
slidingWindowMode: 'messages' | 'tokens';
|
|
71
|
+
slidingWindowMessageLimit: number;
|
|
72
|
+
slidingWindowTokenThreshold: number;
|
|
73
|
+
summarizationEnabled: boolean;
|
|
74
|
+
summarizationTriggerMode: 'messages' | 'tokens';
|
|
75
|
+
summarizeAfterN: number;
|
|
76
|
+
summarizeTokenThreshold: number;
|
|
77
|
+
summarizationHeadMessages: number;
|
|
78
|
+
summarizationTailMessages: number;
|
|
79
|
+
showInterview: boolean;
|
|
80
|
+
websocketEnabled: boolean;
|
|
81
|
+
language?: string;
|
|
82
|
+
routingEnabled: boolean;
|
|
83
|
+
routingStrategy: 'content' | 'cost' | 'content+cost' | 'auto';
|
|
84
|
+
routingContent: {
|
|
85
|
+
coding?: {
|
|
86
|
+
provider: string;
|
|
87
|
+
model: string;
|
|
88
|
+
};
|
|
89
|
+
chat?: {
|
|
90
|
+
provider: string;
|
|
91
|
+
model: string;
|
|
92
|
+
};
|
|
93
|
+
research?: {
|
|
94
|
+
provider: string;
|
|
95
|
+
model: string;
|
|
96
|
+
};
|
|
97
|
+
};
|
|
98
|
+
routingEscalation: {
|
|
99
|
+
enabled: boolean;
|
|
100
|
+
fallbackProvider: string;
|
|
101
|
+
fallbackModel: string;
|
|
102
|
+
checks: ('min_length' | 'constraint' | 'self_check')[];
|
|
103
|
+
minLength: number;
|
|
104
|
+
};
|
|
105
|
+
routingCost: {
|
|
106
|
+
enabled: boolean;
|
|
107
|
+
cheapProvider: string;
|
|
108
|
+
cheapModel: string;
|
|
109
|
+
maxCheapTokens: number;
|
|
110
|
+
};
|
|
111
|
+
subagentRouting: {
|
|
112
|
+
enabled: boolean;
|
|
113
|
+
model?: string;
|
|
114
|
+
provider?: string;
|
|
115
|
+
};
|
|
116
|
+
/** Категория, установленная моделью через classify_conversation. Приоритет над keyword-классификатором. */
|
|
117
|
+
routingCategory?: 'coding' | 'chat' | 'research';
|
|
118
|
+
/** Включить микро-слой: обработка простых запросов без LLM (приветствия, классификация, enum-решения). */
|
|
119
|
+
microFirst: boolean;
|
|
120
|
+
/** Порог уверенности микро-слоя. confidence >= порог → OK, иначе UNSURE → LLM fallback. */
|
|
121
|
+
microConfidenceThreshold: number;
|
|
122
|
+
/** Включить embedding-слой в микро-каскаде. */
|
|
123
|
+
embeddingEnabled: boolean;
|
|
124
|
+
/** Провайдер для embedding-модели. */
|
|
125
|
+
embedProvider?: string;
|
|
126
|
+
/** Модель для embedding. */
|
|
127
|
+
embedModel?: string;
|
|
128
|
+
/**
|
|
129
|
+
* ADR-084: включить decision-уровень в микро-каскаде (перед локальной LLM).
|
|
130
|
+
* Не задано — берётся `config.decision.enabled`; `false` — принудительное
|
|
131
|
+
* отключение уровня в сессии.
|
|
132
|
+
*/
|
|
133
|
+
decisionFirst?: boolean;
|
|
134
|
+
/** Гранулярные permissions сессии. Приоритетнее глобальной секции permission в config.yaml. */
|
|
135
|
+
permission?: PermissionConfig;
|
|
136
|
+
/** Доступность MCP-инструментов по режимам plan/act (serverName → настройки). */
|
|
137
|
+
mcpToolSettings?: Record<string, McpServerToolSettings>;
|
|
138
|
+
/**
|
|
139
|
+
* Per-session override политики включения **встроенных** инструментов. Если
|
|
140
|
+
* задан — перекрывает глобальную `tools.policy` из config.yaml. `auto`
|
|
141
|
+
* резолвится по провайдеру/модели текущего запроса.
|
|
142
|
+
*/
|
|
143
|
+
toolsPolicy?: ToolsPolicy;
|
|
144
|
+
/**
|
|
145
|
+
* Per-session override политики включения **MCP**-инструментов. Если задан —
|
|
146
|
+
* перекрывает глобальную `mcp.policy` из config.yaml. Независима от
|
|
147
|
+
* `toolsPolicy`; `auto` резолвится по провайдеру/модели текущего запроса.
|
|
148
|
+
*/
|
|
149
|
+
mcpPolicy?: ToolsPolicy;
|
|
150
|
+
/** Строгость цикла Plan→Build: auto — модель сама решает, strict — план обязателен, off — планирование отключено. */
|
|
151
|
+
planMode?: PlanMode;
|
|
152
|
+
/** ADR-046: явно включённые в сессии имена скиллов (session level, volatile-каталог). */
|
|
153
|
+
skills?: string[];
|
|
154
|
+
/** ADR-046: opt-out сессии — имена, категории или группы скиллов (volatile-каталог). */
|
|
155
|
+
skillsDisabled?: string[];
|
|
156
|
+
/**
|
|
157
|
+
* ADR-046: СНАПШОТ скиллов «по умолчанию» на момент создания сессии (снимок
|
|
158
|
+
* `project.skills.defaultOn` либо системного дефолта). Изменение дефолта
|
|
159
|
+
* проекта/системы не влияет на существующие сессии.
|
|
160
|
+
*/
|
|
161
|
+
skillsDefaultOn?: string[];
|
|
162
|
+
/** Per-session override LLM Gateway (ADR-036). */
|
|
163
|
+
llmGateway?: {
|
|
164
|
+
enabled?: boolean;
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
export interface StreamInfo {
|
|
168
|
+
streamId: string;
|
|
169
|
+
message: string;
|
|
170
|
+
agentRole?: string;
|
|
171
|
+
startedAt: string;
|
|
172
|
+
cancelled: boolean;
|
|
173
|
+
}
|
|
174
|
+
export interface Branch {
|
|
175
|
+
id: string;
|
|
176
|
+
parentId?: string;
|
|
177
|
+
name: string;
|
|
178
|
+
messages: Message[];
|
|
179
|
+
createdAt: string;
|
|
180
|
+
}
|
|
181
|
+
export interface Checkpoint {
|
|
182
|
+
id: string;
|
|
183
|
+
sessionId: string;
|
|
184
|
+
messages: Message[];
|
|
185
|
+
createdAt: string;
|
|
186
|
+
}
|
|
187
|
+
export interface StickyNote {
|
|
188
|
+
id: string;
|
|
189
|
+
content: string;
|
|
190
|
+
createdAt: string;
|
|
191
|
+
updatedAt: string;
|
|
192
|
+
disabled: boolean;
|
|
193
|
+
}
|
|
194
|
+
export interface SessionReference {
|
|
195
|
+
type: 'session_reference';
|
|
196
|
+
sessionId: string;
|
|
197
|
+
label: string;
|
|
198
|
+
messageRange: [number, number];
|
|
199
|
+
autoSummary?: string;
|
|
200
|
+
createdAt: string;
|
|
201
|
+
}
|
|
202
|
+
export interface Session {
|
|
203
|
+
id: string;
|
|
204
|
+
title?: string;
|
|
205
|
+
/** Канонический ключ иконки (PROJECT_ICON_KEYS); legacy-значения → undefined. */
|
|
206
|
+
icon?: string;
|
|
207
|
+
/** Канонический ключ цвета (PROJECT_COLOR_KEYS); невалидные значения сбрасываются. */
|
|
208
|
+
color?: string;
|
|
209
|
+
sessionOrigin: SessionOrigin;
|
|
210
|
+
parentId?: string;
|
|
211
|
+
branchPoint?: string;
|
|
212
|
+
/** Флаг «план утверждён через plan_exit» (ADR-039), нужен для strict-режима ADR-028. */
|
|
213
|
+
planApproved?: boolean;
|
|
214
|
+
/** Текущий runtime-режим сессии (ADR-025): 'plan' — только чтение, 'act' — полный доступ. */
|
|
215
|
+
mode?: SessionMode;
|
|
216
|
+
/** Todo-список сессии (тул todo_write), как в OpenCode. */
|
|
217
|
+
todos?: TodoItem[];
|
|
218
|
+
/**
|
|
219
|
+
* ADR-070 §2.4/§2.7: состояние промпта per-agent (ключ — agentRole или
|
|
220
|
+
* `__default__`). Пишется только при смене generation.
|
|
221
|
+
*/
|
|
222
|
+
promptStates?: Record<string, PromptState>;
|
|
223
|
+
/** Карта обфускации LLM Gateway (ADR-036). Живёт всю сессию независимо от глобального тумблера. */
|
|
224
|
+
obfuscationMap?: Record<string, string>;
|
|
225
|
+
userId?: string;
|
|
226
|
+
ownerId?: string;
|
|
227
|
+
projectId?: string;
|
|
228
|
+
engine: 'synth' | 'opencode' | 'cline';
|
|
229
|
+
messages: Message[];
|
|
230
|
+
pendingMessages: Message[];
|
|
231
|
+
status: SessionStatus;
|
|
232
|
+
settings: SessionSettings;
|
|
233
|
+
mcpServers?: string[];
|
|
234
|
+
checkpoints: Checkpoint[];
|
|
235
|
+
stickyNotes: StickyNote[];
|
|
236
|
+
references: SessionReference[];
|
|
237
|
+
currentStream?: StreamInfo;
|
|
238
|
+
summarizationPending: boolean;
|
|
239
|
+
canSummarize: boolean;
|
|
240
|
+
createdAt: string;
|
|
241
|
+
updatedAt: string;
|
|
242
|
+
/**
|
|
243
|
+
* ADR-089: ISO-8601 — время авто-архивации ephemeral-сессии (server-managed,
|
|
244
|
+
* клиент задать не может). Задан — сессия скрывается из списков по умолчанию.
|
|
245
|
+
*/
|
|
246
|
+
expiresAt?: string;
|
|
247
|
+
/** ADR-089: ISO-8601 — время архивации сессии (server-managed). */
|
|
248
|
+
archivedAt?: string;
|
|
249
|
+
inputTokens: number;
|
|
250
|
+
outputTokens: number;
|
|
251
|
+
totalTokens: number;
|
|
252
|
+
cacheReadTokens: number;
|
|
253
|
+
cacheWriteTokens: number;
|
|
254
|
+
reasoningTokens: number;
|
|
255
|
+
inputCost: number;
|
|
256
|
+
outputCost: number;
|
|
257
|
+
cacheReadCost: number;
|
|
258
|
+
cacheWriteCost: number;
|
|
259
|
+
/**
|
|
260
|
+
* ADR-070 §2.3: доля кэшированных входных токенов сессии —
|
|
261
|
+
* `cacheReadTokens / inputTokens` (0 при `inputTokens === 0`).
|
|
262
|
+
*/
|
|
263
|
+
cacheHitRate?: number;
|
|
264
|
+
}
|
|
265
|
+
export interface QueueItem {
|
|
266
|
+
message: Message;
|
|
267
|
+
streamId: string;
|
|
268
|
+
enqueuedAt: string;
|
|
269
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export const PLAN_MODES = ['auto', 'strict', 'off'];
|
|
2
|
+
export const SESSION_MODES = ['plan', 'act', 'yolo'];
|
|
3
|
+
/**
|
|
4
|
+
* ADR-071 §2.3: политика включения инструментов в запрос.
|
|
5
|
+
* - `consistency` — в запрос идут все определения, недоступность кодируется
|
|
6
|
+
* permission-слоем (`unavailable(mode|role)`); приоритет — валидность кэша;
|
|
7
|
+
* - `available` — в запрос идут только доступные агенту/режиму/роли тулы;
|
|
8
|
+
* приоритет — экономия контекстного окна;
|
|
9
|
+
* - `auto` — выбор по провайдеру/модели: локальные → `available`, облачные → `consistency`.
|
|
10
|
+
*/
|
|
11
|
+
export const TOOLS_POLICIES = ['consistency', 'available', 'auto'];
|
|
12
|
+
export const TODO_STATUSES = ['pending', 'in_progress', 'completed', 'cancelled'];
|
|
13
|
+
export const TODO_PRIORITIES = ['high', 'medium', 'low'];
|
package/dist/types/skills.d.ts
CHANGED
|
@@ -1,28 +1,28 @@
|
|
|
1
1
|
import type { ToolCapability } from './tools.js';
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
3
|
+
* ADR-046 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
|
|
4
4
|
* Здесь только контракты (типы), без бизнес-логики движка.
|
|
5
5
|
*/
|
|
6
|
-
/** Фактический источник скилла (
|
|
6
|
+
/** Фактический источник скилла (ADR-046 §4.1). */
|
|
7
7
|
export declare const SKILL_SCOPES: readonly ["instance", "project"];
|
|
8
8
|
export type SkillScope = (typeof SKILL_SCOPES)[number];
|
|
9
|
-
/** Уровень включения скилла (модель
|
|
9
|
+
/** Уровень включения скилла (модель ADR-071 §2.4/ADR-046 §4.5). */
|
|
10
10
|
export declare const SKILL_LEVELS: readonly ["system", "project", "session"];
|
|
11
11
|
export type SkillLevel = (typeof SKILL_LEVELS)[number];
|
|
12
12
|
/**
|
|
13
|
-
*
|
|
13
|
+
* ADR-046 §6.1: способ вызова скилла — комбинация `user-invocable` /
|
|
14
14
|
* `disable-model-invocation`.
|
|
15
15
|
*/
|
|
16
16
|
export declare const SKILL_INVOCATIONS: readonly ["both", "user", "model", "none"];
|
|
17
17
|
export type SkillInvocation = (typeof SKILL_INVOCATIONS)[number];
|
|
18
|
-
/**
|
|
18
|
+
/** ADR-046 §3.2: подсказка авто-применения (не разрешение). */
|
|
19
19
|
export declare const SKILL_TRIGGERS: readonly ["manual", "auto"];
|
|
20
20
|
export type SkillTrigger = (typeof SKILL_TRIGGERS)[number];
|
|
21
|
-
/**
|
|
21
|
+
/** ADR-046 §3.2: применимость скилла по режиму сессии (ADR-025). */
|
|
22
22
|
export declare const SKILL_MODES: readonly ["plan", "act", "any"];
|
|
23
23
|
export type SkillMode = (typeof SKILL_MODES)[number];
|
|
24
24
|
/**
|
|
25
|
-
*
|
|
25
|
+
* ADR-046 §3.2: нормализованный frontmatter `SKILL.md` (после толерантного парсинга).
|
|
26
26
|
* Неизвестные top-level ключи не теряются — попадают в `extra`.
|
|
27
27
|
*/
|
|
28
28
|
export interface SkillMeta {
|
|
@@ -66,7 +66,7 @@ export interface SkillMeta {
|
|
|
66
66
|
export type SkillDiagnosticLevel = 'error' | 'warning' | 'info';
|
|
67
67
|
/** Код диагностики/проблемы парсинга. */
|
|
68
68
|
export type SkillIssueCode = 'missing-frontmatter' | 'invalid-frontmatter' | 'invalid-frontmatter-type' | 'missing-name' | 'invalid-name' | 'name-mismatch' | 'missing-description' | 'invalid-description' | 'none-invocation' | 'shadowed' | 'untrusted' | 'read-error'
|
|
69
|
-
/**
|
|
69
|
+
/** ADR-046 §4.2: ошибка удалённого каталога (`skills.urls`): URL/индекс/парсинг. */
|
|
70
70
|
| 'remote';
|
|
71
71
|
/** Проблема парсинга/валидации одного скилла. */
|
|
72
72
|
export interface SkillIssue {
|
|
@@ -84,7 +84,7 @@ export interface SkillDiagnostic extends SkillIssue {
|
|
|
84
84
|
dir?: string;
|
|
85
85
|
}
|
|
86
86
|
/**
|
|
87
|
-
* Запись реестра скиллов (
|
|
87
|
+
* Запись реестра скиллов (ADR-046 §4.5). Доступна через API/диагностику; тело
|
|
88
88
|
* скилла в каталог промпта не попадает (progressive disclosure, §5).
|
|
89
89
|
*/
|
|
90
90
|
export interface SkillSummary {
|
|
@@ -92,7 +92,7 @@ export interface SkillSummary {
|
|
|
92
92
|
description: string;
|
|
93
93
|
/** Фактический scope из источника. */
|
|
94
94
|
scope: SkillScope;
|
|
95
|
-
/** Уровень из источника (system/project; session —
|
|
95
|
+
/** Уровень из источника (system/project; session — ADR-046 §4.5, Фаза 1 без хранения). */
|
|
96
96
|
level: SkillLevel;
|
|
97
97
|
/** Абсолютный путь каталога скилла. */
|
|
98
98
|
dir: string;
|
|
@@ -128,7 +128,7 @@ export interface SkillCatalogFilter {
|
|
|
128
128
|
};
|
|
129
129
|
/** Capabilities агента для проверки `requires_capabilities`. */
|
|
130
130
|
capabilities?: readonly string[];
|
|
131
|
-
/** Per-session явное включение имён (volatile,
|
|
131
|
+
/** Per-session явное включение имён (volatile, ADR-046 §4.5). */
|
|
132
132
|
sessionEnabled?: string[];
|
|
133
133
|
/** Per-session opt-out имён/групп/категорий (volatile). */
|
|
134
134
|
sessionDisabled?: string[];
|