@itphx/synth-shared 0.10.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 +11 -11
- package/dist/config/env-overrides.d.ts +3 -3
- package/dist/config/env-overrides.js +9 -9
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +4 -4
- package/dist/config/resolve.d.ts +10 -10
- package/dist/config/resolve.js +16 -16
- package/dist/config/types.d.ts +190 -190
- package/dist/config/types.js +47 -47
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +16 -10
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/schemas/index.d.ts +96 -96
- package/dist/schemas/index.js +70 -70
- 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 +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/events.d.ts +22 -22
- 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 +4 -4
- package/dist/types/index.d.ts +12 -1165
- package/dist/types/index.js +38 -244
- 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 +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- 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 +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +5 -5
- package/dist/types/webhooks.js +1 -1
- 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
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-052 (этап I): service-key — независимый от binding-key (ADR-089) ключ
|
|
3
3
|
* инстанса для внешних сервисов со **скоупами** (`scopes`) и **проектной
|
|
4
4
|
* проекцией** (`allowedProjects`). Здесь только контракты и browser-safe
|
|
5
5
|
* матчер скоупов; хранилище и enforcement живут в core.
|
|
@@ -7,16 +7,16 @@
|
|
|
7
7
|
import type { GlobalRole } from './index.js';
|
|
8
8
|
/**
|
|
9
9
|
* Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
|
|
10
|
-
* (
|
|
10
|
+
* (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
|
|
11
11
|
*/
|
|
12
12
|
export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules"];
|
|
13
13
|
export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
|
|
14
14
|
/**
|
|
15
|
-
* Каталог скоупов service-key (
|
|
15
|
+
* Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
|
|
16
16
|
* Точечные скоупы вне wildcard-семейств:
|
|
17
17
|
* - `llm:chat` — LLM-прокси (роут без проектного измерения);
|
|
18
18
|
* - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
|
|
19
|
-
* MCP-реестра и скиллов (
|
|
19
|
+
* MCP-реестра и скиллов (PROP-090 installer);
|
|
20
20
|
* - `users:read` — чтение пользователей/идентичностей машинной кредой
|
|
21
21
|
* (консент-сервисы аддонов).
|
|
22
22
|
*/
|
|
@@ -37,7 +37,7 @@ export declare function isKnownScope(scope: string): boolean;
|
|
|
37
37
|
*/
|
|
38
38
|
export declare function hasServiceScope(granted: readonly string[], required: string): boolean;
|
|
39
39
|
/**
|
|
40
|
-
*
|
|
40
|
+
* ADR-052: service-key инстанса.
|
|
41
41
|
*
|
|
42
42
|
* Секрет (`synth_svc_<base64url>`) не хранится в этой сущности: at-rest лежит
|
|
43
43
|
* только sha256-хеш (внутренняя запись хранилища), наружу отдаётся `prefix`.
|
|
@@ -54,11 +54,11 @@ export interface ServiceApiKey {
|
|
|
54
54
|
* managed-режима / доступность эндпоинтов).
|
|
55
55
|
*/
|
|
56
56
|
roles: GlobalRole[];
|
|
57
|
-
/** Выданные скоупы (каталог + wildcard
|
|
57
|
+
/** Выданные скоупы (каталог + wildcard-семейства; ADR-052, `docs/API_V2.md` §1). */
|
|
58
58
|
scopes: string[];
|
|
59
59
|
/**
|
|
60
60
|
* Проектная проекция: ключ ограничен подмножеством проектов инстанса
|
|
61
|
-
* (
|
|
61
|
+
* (ADR-014). Пусто/отсутствует — ключ действует по политике инстанса.
|
|
62
62
|
*/
|
|
63
63
|
allowedProjects?: string[];
|
|
64
64
|
/** Лимит запросов/мин (0 — без лимита); не задан — без лимита. */
|
|
@@ -76,12 +76,12 @@ export interface ServiceApiKey {
|
|
|
76
76
|
/** Префикс секрета для идентификации в UI (plaintext наружу не отдаётся). */
|
|
77
77
|
prefix: string;
|
|
78
78
|
}
|
|
79
|
-
/**
|
|
79
|
+
/** ADR-052: ответ создания service-key — метаданные + однократно показываемый секрет. */
|
|
80
80
|
export interface ServiceApiKeyCreated extends ServiceApiKey {
|
|
81
81
|
/** Plaintext-секрет `synth_svc_<base64url>`; возвращается единственный раз. */
|
|
82
82
|
key: string;
|
|
83
83
|
}
|
|
84
|
-
/**
|
|
84
|
+
/** ADR-052: тело создания service-key (`POST /api/v2/service-keys`). */
|
|
85
85
|
export interface CreateServiceApiKeyInput {
|
|
86
86
|
label: string;
|
|
87
87
|
description?: string;
|
|
@@ -92,7 +92,7 @@ export interface CreateServiceApiKeyInput {
|
|
|
92
92
|
expiresAt?: string;
|
|
93
93
|
}
|
|
94
94
|
/**
|
|
95
|
-
*
|
|
95
|
+
* ADR-052: тело обновления service-key (`PATCH /api/v2/service-keys/:id`).
|
|
96
96
|
* `undefined` — не трогать; `null` — сбросить опциональное значение.
|
|
97
97
|
*/
|
|
98
98
|
export interface UpdateServiceApiKeyPatch {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
|
|
3
|
-
* (
|
|
3
|
+
* (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
|
|
4
4
|
*/
|
|
5
5
|
export const SERVICE_SCOPE_FAMILIES = [
|
|
6
6
|
'events',
|
|
@@ -11,11 +11,11 @@ export const SERVICE_SCOPE_FAMILIES = [
|
|
|
11
11
|
'schedules',
|
|
12
12
|
];
|
|
13
13
|
/**
|
|
14
|
-
* Каталог скоупов service-key (
|
|
14
|
+
* Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
|
|
15
15
|
* Точечные скоупы вне wildcard-семейств:
|
|
16
16
|
* - `llm:chat` — LLM-прокси (роут без проектного измерения);
|
|
17
17
|
* - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
|
|
18
|
-
* MCP-реестра и скиллов (
|
|
18
|
+
* MCP-реестра и скиллов (PROP-090 installer);
|
|
19
19
|
* - `users:read` — чтение пользователей/идентичностей машинной кредой
|
|
20
20
|
* (консент-сервисы аддонов).
|
|
21
21
|
*/
|
|
@@ -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[];
|
package/dist/types/skills.js
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-046 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
|
|
3
3
|
* Здесь только контракты (типы), без бизнес-логики движка.
|
|
4
4
|
*/
|
|
5
|
-
/** Фактический источник скилла (
|
|
5
|
+
/** Фактический источник скилла (ADR-046 §4.1). */
|
|
6
6
|
export const SKILL_SCOPES = ['instance', 'project'];
|
|
7
|
-
/** Уровень включения скилла (модель
|
|
7
|
+
/** Уровень включения скилла (модель ADR-071 §2.4/ADR-046 §4.5). */
|
|
8
8
|
export const SKILL_LEVELS = ['system', 'project', 'session'];
|
|
9
9
|
/**
|
|
10
|
-
*
|
|
10
|
+
* ADR-046 §6.1: способ вызова скилла — комбинация `user-invocable` /
|
|
11
11
|
* `disable-model-invocation`.
|
|
12
12
|
*/
|
|
13
13
|
export const SKILL_INVOCATIONS = ['both', 'user', 'model', 'none'];
|
|
14
|
-
/**
|
|
14
|
+
/** ADR-046 §3.2: подсказка авто-применения (не разрешение). */
|
|
15
15
|
export const SKILL_TRIGGERS = ['manual', 'auto'];
|
|
16
|
-
/**
|
|
16
|
+
/** ADR-046 §3.2: применимость скилла по режиму сессии (ADR-025). */
|
|
17
17
|
export const SKILL_MODES = ['plan', 'act', 'any'];
|
package/dist/types/tools.d.ts
CHANGED
|
@@ -33,7 +33,7 @@ export interface ToolResult {
|
|
|
33
33
|
}
|
|
34
34
|
export type ToolExecutor = (params: unknown, ctx: ToolContext) => Promise<ToolResult>;
|
|
35
35
|
/**
|
|
36
|
-
*
|
|
36
|
+
* ADR-071 §2.1: источник инструмента. `builtin` — встроенный (слой `tools`,
|
|
37
37
|
* `stable`), `mcp` — инструмент MCP-сервера (слой `mcp.tools`, `volatile`).
|
|
38
38
|
* Для встроенных проставляется по умолчанию в `ToolRegistry.register`.
|
|
39
39
|
*/
|
|
@@ -45,9 +45,9 @@ export interface ToolDefinition {
|
|
|
45
45
|
capabilities: ToolCapability[];
|
|
46
46
|
execute: ToolExecutor;
|
|
47
47
|
jsonSchema?: Record<string, unknown>;
|
|
48
|
-
/**
|
|
48
|
+
/** ADR-071 §2.1: источник инструмента (builtin/mcp). */
|
|
49
49
|
source?: ToolSource;
|
|
50
|
-
/**
|
|
50
|
+
/** ADR-071 §2.1: имя MCP-сервера для `source: 'mcp'`. */
|
|
51
51
|
mcpServer?: string;
|
|
52
52
|
}
|
|
53
53
|
export interface ToolForLLM {
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
export declare enum GlobalRole {
|
|
2
|
+
ADMIN = "ADMIN",
|
|
3
|
+
USER = "USER",
|
|
4
|
+
LEAD = "LEAD",
|
|
5
|
+
AUDITOR = "AUDITOR"
|
|
6
|
+
}
|
|
7
|
+
export interface User {
|
|
8
|
+
id: string;
|
|
9
|
+
username: string;
|
|
10
|
+
email?: string;
|
|
11
|
+
roles: string[];
|
|
12
|
+
preferredLanguage: string;
|
|
13
|
+
createdAt: string;
|
|
14
|
+
teamRole: string;
|
|
15
|
+
notes: string;
|
|
16
|
+
interviewCompleted: boolean;
|
|
17
|
+
isLocal?: boolean;
|
|
18
|
+
isTestUser?: boolean;
|
|
19
|
+
}
|
|
20
|
+
export interface TestUser {
|
|
21
|
+
username: string;
|
|
22
|
+
apiKey: string;
|
|
23
|
+
roles: string[];
|
|
24
|
+
displayName: string;
|
|
25
|
+
}
|
|
26
|
+
export interface AuthConfig {
|
|
27
|
+
debugMode: boolean;
|
|
28
|
+
apiKey?: string;
|
|
29
|
+
testUsers?: TestUser[];
|
|
30
|
+
sessionMaxAgeMinutes: number;
|
|
31
|
+
oidc?: {
|
|
32
|
+
enabled: boolean;
|
|
33
|
+
issuer: string;
|
|
34
|
+
clientId: string;
|
|
35
|
+
clientSecret: string;
|
|
36
|
+
redirectUri: string;
|
|
37
|
+
/** Public client_id для локального CLI/core (ROPC/device flow). Не секрет. */
|
|
38
|
+
cliClientId?: string;
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* ADR-089: внешняя идентичность, привязанная к профилю пользователя.
|
|
43
|
+
* Ключ — `provider` + `externalId` (числовой id источника). `username`/
|
|
44
|
+
* `displayName` — display-кэш (может устареть), НЕ ключ.
|
|
45
|
+
*/
|
|
46
|
+
export interface ExternalIdentity {
|
|
47
|
+
/** Префикс principalId (ADR-089), напр. 'tg' (Telegram). */
|
|
48
|
+
provider: string;
|
|
49
|
+
/** Числовой id в источнике, строкой (напр. '450316139'). */
|
|
50
|
+
externalId: string;
|
|
51
|
+
/** Display-кэш: username источника (может устареть). */
|
|
52
|
+
username?: string;
|
|
53
|
+
/** Display-кэш: отображаемое имя источника. */
|
|
54
|
+
displayName?: string;
|
|
55
|
+
/** ISO: когда привязано. */
|
|
56
|
+
linkedAt: string;
|
|
57
|
+
/** Кто подтвердил (id пользователя инстанса). */
|
|
58
|
+
linkedBy?: string;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* ADR-089: principalId внешнего отправителя из пары провайдер+id.
|
|
62
|
+
* Формат — `<provider>:<externalId>` (напр. `tg:450316139`).
|
|
63
|
+
*/
|
|
64
|
+
export declare function buildPrincipalId(provider: string, externalId: string): string;
|
|
65
|
+
/**
|
|
66
|
+
* ADR-089: разбор principalId на `provider`/`externalId` — деление по **первому**
|
|
67
|
+
* `:`. Невалидное (нет `:`, пустые части) → `null`.
|
|
68
|
+
*/
|
|
69
|
+
export declare function parsePrincipalId(principalId: string): {
|
|
70
|
+
provider: string;
|
|
71
|
+
externalId: string;
|
|
72
|
+
} | null;
|
|
73
|
+
export interface ProfileData {
|
|
74
|
+
id: string;
|
|
75
|
+
username: string;
|
|
76
|
+
email?: string;
|
|
77
|
+
phone?: string;
|
|
78
|
+
roles: string[];
|
|
79
|
+
teamRoles: string[];
|
|
80
|
+
isActive: boolean;
|
|
81
|
+
preferences: Record<string, unknown>;
|
|
82
|
+
notes: string;
|
|
83
|
+
/**
|
|
84
|
+
* Онбординг-интервью пройдено. Отдельное поле вместо legacy-метки
|
|
85
|
+
* `[ИНТЕРВЬЮ]` в свободном `notes`. Не задано (legacy-профиль) — бэкфилл при
|
|
86
|
+
* чтении по наличию метки (`FileProfileStore._deserialize`).
|
|
87
|
+
*/
|
|
88
|
+
interviewCompleted: boolean;
|
|
89
|
+
/** ISO-время завершения интервью (для аудита/аналитики). */
|
|
90
|
+
interviewCompletedAt?: string;
|
|
91
|
+
displayName?: string;
|
|
92
|
+
/**
|
|
93
|
+
* ADR-089: внешние идентичности (Telegram и др.), привязанные к профилю.
|
|
94
|
+
* Опционально — legacy-профили без поля трактуются как `[]`. Ключ — пара
|
|
95
|
+
* `provider`+`externalId`; `username`/`displayName` — display-кэш.
|
|
96
|
+
*/
|
|
97
|
+
identities?: ExternalIdentity[];
|
|
98
|
+
createdAt: string;
|
|
99
|
+
updatedAt: string;
|
|
100
|
+
lastLogin?: string;
|
|
101
|
+
}
|
|
102
|
+
export interface InterviewQuestion {
|
|
103
|
+
id: string;
|
|
104
|
+
question: string;
|
|
105
|
+
order: number;
|
|
106
|
+
}
|
|
107
|
+
export interface InterviewStatus {
|
|
108
|
+
inProgress: boolean;
|
|
109
|
+
completed: boolean;
|
|
110
|
+
currentQuestion?: InterviewQuestion;
|
|
111
|
+
totalQuestions: number;
|
|
112
|
+
answered: number;
|
|
113
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
// --- User role ---
|
|
2
|
+
export var GlobalRole;
|
|
3
|
+
(function (GlobalRole) {
|
|
4
|
+
GlobalRole["ADMIN"] = "ADMIN";
|
|
5
|
+
GlobalRole["USER"] = "USER";
|
|
6
|
+
GlobalRole["LEAD"] = "LEAD";
|
|
7
|
+
GlobalRole["AUDITOR"] = "AUDITOR";
|
|
8
|
+
})(GlobalRole || (GlobalRole = {}));
|
|
9
|
+
/**
|
|
10
|
+
* ADR-089: principalId внешнего отправителя из пары провайдер+id.
|
|
11
|
+
* Формат — `<provider>:<externalId>` (напр. `tg:450316139`).
|
|
12
|
+
*/
|
|
13
|
+
export function buildPrincipalId(provider, externalId) {
|
|
14
|
+
return `${provider}:${externalId}`;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* ADR-089: разбор principalId на `provider`/`externalId` — деление по **первому**
|
|
18
|
+
* `:`. Невалидное (нет `:`, пустые части) → `null`.
|
|
19
|
+
*/
|
|
20
|
+
export function parsePrincipalId(principalId) {
|
|
21
|
+
if (typeof principalId !== 'string')
|
|
22
|
+
return null;
|
|
23
|
+
const idx = principalId.indexOf(':');
|
|
24
|
+
if (idx <= 0 || idx === principalId.length - 1)
|
|
25
|
+
return null;
|
|
26
|
+
const provider = principalId.slice(0, idx);
|
|
27
|
+
const externalId = principalId.slice(idx + 1);
|
|
28
|
+
if (!provider || !externalId)
|
|
29
|
+
return null;
|
|
30
|
+
return { provider, externalId };
|
|
31
|
+
}
|