@itphx/synth-shared 0.10.0 → 0.11.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 +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- 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 +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- 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/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -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/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- 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 +237 -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 +268 -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 +6 -6
- 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.d.ts +15 -0
- package/dist/utils/index.js +55 -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,268 @@
|
|
|
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
|
+
messages: Message[];
|
|
229
|
+
pendingMessages: Message[];
|
|
230
|
+
status: SessionStatus;
|
|
231
|
+
settings: SessionSettings;
|
|
232
|
+
mcpServers?: string[];
|
|
233
|
+
checkpoints: Checkpoint[];
|
|
234
|
+
stickyNotes: StickyNote[];
|
|
235
|
+
references: SessionReference[];
|
|
236
|
+
currentStream?: StreamInfo;
|
|
237
|
+
summarizationPending: boolean;
|
|
238
|
+
canSummarize: boolean;
|
|
239
|
+
createdAt: string;
|
|
240
|
+
updatedAt: string;
|
|
241
|
+
/**
|
|
242
|
+
* ADR-089: ISO-8601 — время авто-архивации ephemeral-сессии (server-managed,
|
|
243
|
+
* клиент задать не может). Задан — сессия скрывается из списков по умолчанию.
|
|
244
|
+
*/
|
|
245
|
+
expiresAt?: string;
|
|
246
|
+
/** ADR-089: ISO-8601 — время архивации сессии (server-managed). */
|
|
247
|
+
archivedAt?: string;
|
|
248
|
+
inputTokens: number;
|
|
249
|
+
outputTokens: number;
|
|
250
|
+
totalTokens: number;
|
|
251
|
+
cacheReadTokens: number;
|
|
252
|
+
cacheWriteTokens: number;
|
|
253
|
+
reasoningTokens: number;
|
|
254
|
+
inputCost: number;
|
|
255
|
+
outputCost: number;
|
|
256
|
+
cacheReadCost: number;
|
|
257
|
+
cacheWriteCost: number;
|
|
258
|
+
/**
|
|
259
|
+
* ADR-070 §2.3: доля кэшированных входных токенов сессии —
|
|
260
|
+
* `cacheReadTokens / inputTokens` (0 при `inputTokens === 0`).
|
|
261
|
+
*/
|
|
262
|
+
cacheHitRate?: number;
|
|
263
|
+
}
|
|
264
|
+
export interface QueueItem {
|
|
265
|
+
message: Message;
|
|
266
|
+
streamId: string;
|
|
267
|
+
enqueuedAt: string;
|
|
268
|
+
}
|
|
@@ -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
|
+
}
|
package/dist/types/webhooks.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-052 (этап II): исходящие webhooks — подписки и журнал доставок. Здесь
|
|
3
3
|
* только контракты (browser-safe): сами хранилище и движок доставки живут в core.
|
|
4
4
|
*/
|
|
5
5
|
/** Префикс signing-секрета подписки (`whsec_<base64url>`). */
|
|
@@ -23,7 +23,7 @@ export declare function matchWebhookEvent(patterns: readonly string[] | undefine
|
|
|
23
23
|
/** Формат паттерна события: `foo.bar` либо `foo.*` (без пробелов/пустых сегментов). */
|
|
24
24
|
export declare function isWebhookEventPattern(value: string): boolean;
|
|
25
25
|
/**
|
|
26
|
-
*
|
|
26
|
+
* ADR-052 (этап II): подписка на исходящие события. Секрет подписи (`secret`)
|
|
27
27
|
* наружу не отдаётся — только `secretPrefix`; полный секрет возвращается
|
|
28
28
|
* единственный раз в `WebhookSubscriptionCreated`.
|
|
29
29
|
*/
|
|
@@ -33,7 +33,7 @@ export interface WebhookSubscription {
|
|
|
33
33
|
/** Обязательная метка (уникальна глобально по инстансу, регистронезависимо). */
|
|
34
34
|
label: string;
|
|
35
35
|
description?: string;
|
|
36
|
-
/** Целевой URL (https; http — только при `webhooks.
|
|
36
|
+
/** Целевой URL (https; http — только при `egress.webhooks.mode: 'off'`). */
|
|
37
37
|
url: string;
|
|
38
38
|
/** Паттерны событий (exact или `prefix.*`); пусто — дефолтный набор. */
|
|
39
39
|
events: string[];
|
|
@@ -57,7 +57,7 @@ export interface WebhookSubscriptionCreated extends WebhookSubscription {
|
|
|
57
57
|
/** Plaintext signing-секрет `whsec_<base64url>`; возвращается единственный раз. */
|
|
58
58
|
secret: string;
|
|
59
59
|
}
|
|
60
|
-
/**
|
|
60
|
+
/** ADR-052 (этап II): запись журнала доставки webhook. */
|
|
61
61
|
export interface WebhookDelivery {
|
|
62
62
|
/** `whd_<uuid>`. */
|
|
63
63
|
id: string;
|
|
@@ -76,7 +76,7 @@ export interface WebhookDelivery {
|
|
|
76
76
|
/** ISO-8601 завершения доставки. */
|
|
77
77
|
completedAt?: string;
|
|
78
78
|
}
|
|
79
|
-
/**
|
|
79
|
+
/** ADR-052 (этап II): тело создания подписки (`POST /api/v2/webhooks`). */
|
|
80
80
|
export interface CreateWebhookSubscriptionInput {
|
|
81
81
|
label: string;
|
|
82
82
|
description?: string;
|
|
@@ -85,7 +85,7 @@ export interface CreateWebhookSubscriptionInput {
|
|
|
85
85
|
enabled?: boolean;
|
|
86
86
|
}
|
|
87
87
|
/**
|
|
88
|
-
*
|
|
88
|
+
* ADR-052 (этап II): тело обновления подписки. `undefined` — не трогать;
|
|
89
89
|
* `null` — сбросить опциональное значение (`description`).
|
|
90
90
|
*/
|
|
91
91
|
export interface UpdateWebhookSubscriptionPatch {
|
package/dist/types/webhooks.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-052 (этап II): исходящие webhooks — подписки и журнал доставок. Здесь
|
|
3
3
|
* только контракты (browser-safe): сами хранилище и движок доставки живут в core.
|
|
4
4
|
*/
|
|
5
5
|
/** Префикс signing-секрета подписки (`whsec_<base64url>`). */
|
package/dist/utils/glob.d.ts
CHANGED
package/dist/utils/glob.js
CHANGED
package/dist/utils/index.d.ts
CHANGED
|
@@ -4,6 +4,21 @@ export declare function formatISODate(date: Date): string;
|
|
|
4
4
|
export declare function nowISO(): string;
|
|
5
5
|
export declare function safeJsonParse<T>(data: string, fallback: T): T;
|
|
6
6
|
export declare function atomicWrite(writeFile: (path: string, data: string) => Promise<void>, rename: (oldPath: string, newPath: string) => Promise<void>, targetPath: string, data: string): Promise<void>;
|
|
7
|
+
/**
|
|
8
|
+
* Удаляет NUL-символы (`\u0000`) из строки. PostgreSQL не принимает U+0000
|
|
9
|
+
* ни в `text` («invalid byte sequence for encoding "UTF8": 0x00»), ни в `jsonb`
|
|
10
|
+
* (`JSON.stringify` даёт escape `\u0000` → «unsupported Unicode escape
|
|
11
|
+
* sequence»), поэтому недоверенный текст (ответ модели, вывод тулов/файлов/
|
|
12
|
+
* shell/веба) чистится до записи. Остальные символы не меняются; исходная
|
|
13
|
+
* строка возвращается, если NUL-байтов нет.
|
|
14
|
+
*/
|
|
15
|
+
export declare function stripNullBytes(value: string): string;
|
|
16
|
+
/**
|
|
17
|
+
* Рекурсивно удаляет NUL-байты из строк в массивах/plain-объектах.
|
|
18
|
+
* `Date`, `Buffer` и прочие non-plain объекты возвращаются как есть.
|
|
19
|
+
* Если изменений нет — возвращается исходное значение (та же ссылка).
|
|
20
|
+
*/
|
|
21
|
+
export declare function stripNullBytesDeep<T>(value: T): T;
|
|
7
22
|
export declare class AsyncLock {
|
|
8
23
|
private _locked;
|
|
9
24
|
private _waiting;
|