@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.
Files changed (72) hide show
  1. package/dist/config/defaults.js +51 -1
  2. package/dist/config/env-overrides.d.ts +68 -0
  3. package/dist/config/env-overrides.js +165 -0
  4. package/dist/config/index.d.ts +1 -0
  5. package/dist/config/index.js +1 -0
  6. package/dist/config/loader.d.ts +3 -1
  7. package/dist/config/loader.js +12 -4
  8. package/dist/config/resolve.d.ts +23 -6
  9. package/dist/config/resolve.js +33 -12
  10. package/dist/config/types.d.ts +699 -146
  11. package/dist/config/types.js +195 -28
  12. package/dist/i18n/index.d.ts +1 -1
  13. package/dist/i18n/index.js +50 -8
  14. package/dist/index.d.ts +4 -2
  15. package/dist/index.js +3 -2
  16. package/dist/interfaces/index.d.ts +8 -1
  17. package/dist/schemas/index.d.ts +1723 -45
  18. package/dist/schemas/index.js +403 -29
  19. package/dist/skills/frontmatter.js +1 -1
  20. package/dist/types/agent.d.ts +30 -0
  21. package/dist/types/agent.js +1 -0
  22. package/dist/types/bus-events.d.ts +7 -0
  23. package/dist/types/bus-events.js +1 -0
  24. package/dist/types/commands.d.ts +10 -10
  25. package/dist/types/commands.js +2 -2
  26. package/dist/types/decision.d.ts +502 -0
  27. package/dist/types/decision.js +98 -0
  28. package/dist/types/events.d.ts +219 -0
  29. package/dist/types/events.js +1 -0
  30. package/dist/types/fs.d.ts +44 -0
  31. package/dist/types/fs.js +16 -0
  32. package/dist/types/git.d.ts +63 -0
  33. package/dist/types/git.js +1 -0
  34. package/dist/types/hooks.d.ts +96 -0
  35. package/dist/types/hooks.js +1 -0
  36. package/dist/types/index.d.ts +18 -1097
  37. package/dist/types/index.js +44 -215
  38. package/dist/types/llm.d.ts +32 -0
  39. package/dist/types/llm.js +8 -0
  40. package/dist/types/mcp.d.ts +104 -0
  41. package/dist/types/mcp.js +40 -0
  42. package/dist/types/message.d.ts +63 -0
  43. package/dist/types/message.js +12 -0
  44. package/dist/types/permission.d.ts +2 -2
  45. package/dist/types/permission.js +1 -1
  46. package/dist/types/project.d.ts +134 -0
  47. package/dist/types/project.js +67 -0
  48. package/dist/types/prompt.d.ts +236 -0
  49. package/dist/types/prompt.js +15 -0
  50. package/dist/types/provider.d.ts +84 -0
  51. package/dist/types/provider.js +35 -0
  52. package/dist/types/schedules.d.ts +109 -0
  53. package/dist/types/schedules.js +9 -0
  54. package/dist/types/service-keys.d.ts +106 -0
  55. package/dist/types/service-keys.js +72 -0
  56. package/dist/types/session.d.ts +269 -0
  57. package/dist/types/session.js +13 -0
  58. package/dist/types/skills.d.ts +11 -11
  59. package/dist/types/skills.js +6 -6
  60. package/dist/types/tools.d.ts +4 -3
  61. package/dist/types/tools.js +2 -0
  62. package/dist/types/user.d.ts +113 -0
  63. package/dist/types/user.js +31 -0
  64. package/dist/types/webhooks.d.ts +97 -0
  65. package/dist/types/webhooks.js +53 -0
  66. package/dist/utils/glob.d.ts +1 -1
  67. package/dist/utils/glob.js +1 -1
  68. package/dist/utils/index.js +2 -2
  69. package/dist/utils/workspace.js +1 -1
  70. package/dist/version.d.ts +1 -1
  71. package/dist/version.js +1 -1
  72. package/package.json +1 -1
@@ -0,0 +1,134 @@
1
+ import type { GitRepoConfig } from './git.js';
2
+ export declare enum ProjectRole {
3
+ OWNER = "owner",
4
+ EDITOR = "editor",
5
+ VIEWER = "viewer"
6
+ }
7
+ export declare enum StatusMessageType {
8
+ INFO = "info",
9
+ WARNING = "warning",
10
+ ERROR = "error",
11
+ STREAM = "stream"
12
+ }
13
+ export interface StatusMessage {
14
+ id: string;
15
+ text: string;
16
+ type: StatusMessageType;
17
+ timestamp: string;
18
+ }
19
+ export interface ProjectLogEntry {
20
+ id: string;
21
+ text: string;
22
+ createdAt: string;
23
+ sessionId?: string;
24
+ author?: string;
25
+ }
26
+ /**
27
+ * ADR-071 §2.4/§2.5: проектный скоуп MCP — ссылки на записи единого реестра по
28
+ * имени.
29
+ * - `enabled` — hard-gate: серверы, разрешённые проекту. Не разрешённый сервер
30
+ * недоступен ни в одной сессии проекта (в т.ч. старой). Пустой массив — «всё
31
+ * выключено» (opt-in); отсутствие `project.mcp` — гейт не задан (legacy).
32
+ * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот `mcpDefaultOn`
33
+ * при создании сессии. Изменение не влияет на ранее созданные сессии.
34
+ */
35
+ export interface ProjectMcpSettings {
36
+ enabled: string[];
37
+ defaultOn: string[];
38
+ }
39
+ /**
40
+ * ADR-046 §4.5: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
41
+ * - `enabled` — hard-gate: доступные проекту скиллы. Пустой массив — «всё
42
+ * выключено» (opt-in); отсутствие `project.skills` — гейт не задан (legacy).
43
+ * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот
44
+ * `skillsDefaultOn` при создании сессии.
45
+ */
46
+ export interface ProjectSkillSettings {
47
+ enabled: string[];
48
+ defaultOn: string[];
49
+ }
50
+ /**
51
+ * ADR-075: политика для абсолютного `project.workspace` вне `workspacesRoot`.
52
+ * - `confirm` — путь разрешён только с явным подтверждением (`confirmOutsideRoot`);
53
+ * - `deny` — путь запрещён (managed-развёртывание: жёстко).
54
+ *
55
+ * Значение `''` (пустая строка) в конфиге означает «не задано» — эффективной
56
+ * политикой тогда считается `confirm` (резолвер `resolveWorkspaceOutsideRootPolicy`).
57
+ */
58
+ export type WorkspaceOutsideRootPolicy = 'confirm' | 'deny';
59
+ /**
60
+ * ADR-075: ответ `GET /api/v2/settings/workspace-policy`.
61
+ * `readOnly` (additive) — managed-развёртывание: политика задаётся развёртыванием,
62
+ * `PUT`/`DELETE` возвращают 403 `WORKSPACE_POLICY_READ_ONLY`.
63
+ */
64
+ export interface WorkspacePolicyInfo {
65
+ outsideRoot: WorkspaceOutsideRootPolicy;
66
+ isOverridden: boolean;
67
+ defaults: WorkspaceOutsideRootPolicy;
68
+ readOnly?: boolean;
69
+ }
70
+ export interface Project {
71
+ id: string;
72
+ name: string;
73
+ ownerId: string;
74
+ members: Record<string, ProjectRole>;
75
+ description: string;
76
+ currentTask: string;
77
+ invariants: string;
78
+ icon?: string;
79
+ color?: string;
80
+ workspace?: string;
81
+ repos?: GitRepoConfig[];
82
+ /** ADR-071 §2.4: проектный скоуп MCP (owner/lead). */
83
+ mcp?: ProjectMcpSettings;
84
+ /** ADR-046 §4.5: проектный скоуп скиллов (owner/lead). */
85
+ skills?: ProjectSkillSettings;
86
+ statusMessages: StatusMessage[];
87
+ /** Kanban-план проекта (ADR-039). Владеет проектом, а не сессией. */
88
+ plan?: ProjectPlan;
89
+ /** Лог работ проекта (ведётся моделью через project_log_write). */
90
+ log?: ProjectLogEntry[];
91
+ createdAt: string;
92
+ updatedAt: string;
93
+ }
94
+ /**
95
+ * Канонические ключи иконок проектов и сессий (единый список для server и UI).
96
+ * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
97
+ */
98
+ export declare const PROJECT_ICON_KEYS: readonly ["code", "terminal", "rocket", "flask", "gamepad", "briefcase", "home", "globe", "leaf", "shield", "palette", "server", "phone", "database", "lightbulb", "music", "camera", "book", "heart", "folder", "chat", "cpu", "file", "file-code", "docs", "task", "todo", "bug", "robot", "brain", "git", "repo", "test", "chart", "star", "image", "calendar"];
99
+ export type ProjectIconKey = (typeof PROJECT_ICON_KEYS)[number];
100
+ /**
101
+ * Канонические ключи цветов проектов и сессий — 16 цветов палитры темы
102
+ * (`palette.colors[].key` в `a1..a16`; единый список для server и UI).
103
+ */
104
+ export declare const PROJECT_COLOR_KEYS: readonly ["a1", "a2", "a3", "a4", "a5", "a6", "a7", "a8", "a9", "a10", "a11", "a12", "a13", "a14", "a15", "a16"];
105
+ export type ProjectColorKey = (typeof PROJECT_COLOR_KEYS)[number];
106
+ export interface PlanColumn {
107
+ id: string;
108
+ name: string;
109
+ order: number;
110
+ wipLimit?: number;
111
+ }
112
+ export interface PlanDependency {
113
+ projectId?: string;
114
+ itemId: string;
115
+ relation: 'blocked_by' | 'blocks' | 'relates_to';
116
+ }
117
+ export interface PlanItem {
118
+ id: string;
119
+ title: string;
120
+ description?: string;
121
+ columnId: string;
122
+ priority: 'high' | 'medium' | 'low';
123
+ order: number;
124
+ dependsOn: PlanDependency[];
125
+ tags?: string[];
126
+ createdAt: string;
127
+ updatedAt: string;
128
+ }
129
+ export interface ProjectPlan {
130
+ version: number;
131
+ updatedAt: string;
132
+ columns: PlanColumn[];
133
+ items: PlanItem[];
134
+ }
@@ -0,0 +1,67 @@
1
+ // --- Project role ---
2
+ export var ProjectRole;
3
+ (function (ProjectRole) {
4
+ ProjectRole["OWNER"] = "owner";
5
+ ProjectRole["EDITOR"] = "editor";
6
+ ProjectRole["VIEWER"] = "viewer";
7
+ })(ProjectRole || (ProjectRole = {}));
8
+ export var StatusMessageType;
9
+ (function (StatusMessageType) {
10
+ StatusMessageType["INFO"] = "info";
11
+ StatusMessageType["WARNING"] = "warning";
12
+ StatusMessageType["ERROR"] = "error";
13
+ StatusMessageType["STREAM"] = "stream";
14
+ })(StatusMessageType || (StatusMessageType = {}));
15
+ /**
16
+ * Канонические ключи иконок проектов и сессий (единый список для server и UI).
17
+ * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
18
+ */
19
+ export const PROJECT_ICON_KEYS = [
20
+ 'code',
21
+ 'terminal',
22
+ 'rocket',
23
+ 'flask',
24
+ 'gamepad',
25
+ 'briefcase',
26
+ 'home',
27
+ 'globe',
28
+ 'leaf',
29
+ 'shield',
30
+ 'palette',
31
+ 'server',
32
+ 'phone',
33
+ 'database',
34
+ 'lightbulb',
35
+ 'music',
36
+ 'camera',
37
+ 'book',
38
+ 'heart',
39
+ 'folder',
40
+ 'chat',
41
+ 'cpu',
42
+ 'file',
43
+ 'file-code',
44
+ 'docs',
45
+ 'task',
46
+ 'todo',
47
+ 'bug',
48
+ 'robot',
49
+ 'brain',
50
+ 'git',
51
+ 'repo',
52
+ 'test',
53
+ 'chart',
54
+ 'star',
55
+ 'image',
56
+ 'calendar',
57
+ ];
58
+ /**
59
+ * Канонические ключи цветов проектов и сессий — 16 цветов палитры темы
60
+ * (`palette.colors[].key` в `a1..a16`; единый список для server и UI).
61
+ */
62
+ export const PROJECT_COLOR_KEYS = [
63
+ 'a1', 'a2', 'a3', 'a4',
64
+ 'a5', 'a6', 'a7', 'a8',
65
+ 'a9', 'a10', 'a11', 'a12',
66
+ 'a13', 'a14', 'a15', 'a16',
67
+ ];
@@ -0,0 +1,236 @@
1
+ import type { ToolsPolicy } from './session.js';
2
+ /** Состояние одного блока системного промпта (хэш/размер для диагностики). */
3
+ export interface PromptBlockState {
4
+ key: string;
5
+ hash: string;
6
+ chars: number;
7
+ }
8
+ /**
9
+ * ADR-070 §2.4: состояние системного промпта per-agent. Хранится в сессии
10
+ * (`Session.promptStates`) и пишется только при смене generation.
11
+ */
12
+ export interface PromptState {
13
+ generation: number;
14
+ /** sha256(stablePrefix). */
15
+ staticPrefixHash: string;
16
+ /** Закреплённые байты кэшируемого префикса. */
17
+ staticPrefix: string;
18
+ /** sha256(полного system). */
19
+ systemHash: string;
20
+ blocks: PromptBlockState[];
21
+ reason: 'init' | 'compaction' | 'generation-change' | 'override' | 'agent-change';
22
+ updatedAt: string;
23
+ }
24
+ /** ADR-070 §2.4: компактная мета промпта, кладётся в assistant-сообщение. */
25
+ export interface PromptMeta {
26
+ /** agentKey, к которому относится ход (agentRole или `__default__`). */
27
+ agentRole?: string;
28
+ generation: number;
29
+ /** Предсказание по staticPrefixHash. */
30
+ expected: 'hit' | 'miss';
31
+ /** Фактический cacheRead из usage. */
32
+ cachedTokens: number;
33
+ /** expected подтверждён/опровергнут фактом. */
34
+ validated: boolean;
35
+ }
36
+ /** Тир консистентности блока системного промпта (ADR-070 §2.1). */
37
+ export type PromptTier = 'stable' | 'context' | 'volatile';
38
+ /** Статус блока в манифесте промпта. */
39
+ export type PromptManifestStatus = 'loaded' | 'truncated' | 'empty' | 'blocked' | 'suppressed';
40
+ /** ADR-070 §2.5: запись манифеста — источник системного промпта. */
41
+ export interface PromptManifestEntry {
42
+ key: string;
43
+ label: string;
44
+ tier: PromptTier;
45
+ /** Порядок блока внутри тира (реальный порядок отправки, ADR-070 §2.5). */
46
+ order?: number;
47
+ chars: number;
48
+ /** Эвристика: Math.ceil(chars / 4). */
49
+ estTokens: number;
50
+ status: PromptManifestStatus;
51
+ provenance?: string;
52
+ /**
53
+ * Источник записи: `system` — блок системного промпта, `tools` — слой
54
+ * встроенных инструментов (stable, ADR-070 §2.5), `mcp.tools` — слой
55
+ * MCP-инструментов (volatile, ADR-071 §2.1). Слои инструментов не входят в
56
+ * system-текст, но отражаются в манифесте и размерах.
57
+ */
58
+ source?: 'system' | 'tools' | 'mcp.tools';
59
+ }
60
+ /** ADR-070 §2.5: манифест состава системного промпта (для API/UI/тестов). */
61
+ export interface PromptManifest {
62
+ generation?: number;
63
+ totalChars: number;
64
+ estTokens: number;
65
+ staticPrefixChars: number;
66
+ /**
67
+ * ADR-071 §2.3: фактически применённая политика **встроенных** инструментов
68
+ * (`auto` уже разрешён в `consistency`/`available`) — видно, какая политика
69
+ * сработала.
70
+ */
71
+ toolsPolicy?: Exclude<ToolsPolicy, 'auto'>;
72
+ /**
73
+ * ADR-071 §2.3: фактически применённая политика **MCP**-инструментов
74
+ * (`auto` уже разрешён в `consistency`/`available`). Независима от
75
+ * `toolsPolicy`.
76
+ */
77
+ mcpPolicy?: Exclude<ToolsPolicy, 'auto'>;
78
+ /**
79
+ * ADR-071 §2.6: chars-per-token, применённый к `estTokens` (калибровка по
80
+ * фактическому usage; 4 — без калибровки). `estTokens` — оценка, не факт.
81
+ */
82
+ ratio?: number;
83
+ entries: PromptManifestEntry[];
84
+ }
85
+ /** Дефолтный chars-per-token, если калибровки для модели нет. */
86
+ export declare const DEFAULT_CHARS_PER_TOKEN = 4;
87
+ /**
88
+ * Нижняя граница разумного chars-per-token (аномальные семплы отбрасываются).
89
+ * CJK/эффективные BPE дают ~1–2 символа на токен, поэтому допускаем 1.5.
90
+ */
91
+ export declare const MIN_CHARS_PER_TOKEN = 1.5;
92
+ /**
93
+ * Верхняя граница разумного chars-per-token. Берётся с запасом: «эффективные»
94
+ * токенизаторы (например, `omn.qwen3.8:27b`) дают ratio ≈ 11.7.
95
+ */
96
+ export declare const MAX_CHARS_PER_TOKEN = 16;
97
+ /** Минимальный `usage.inputTokens` для калибровки — меньшие значения шумные. */
98
+ export declare const MIN_CALIBRATION_INPUT_TOKENS = 500;
99
+ /**
100
+ * ADR-071 §2.6: строка таблицы «Встроенные инструменты» в панели статистики.
101
+ * Отдаётся `GET /sessions/:id/prompt` полем `toolsDetail` (аддитивно).
102
+ */
103
+ export interface PromptToolDetail {
104
+ name: string;
105
+ capabilities: string[];
106
+ /** Доступен ли тул текущему режиму/роли (`computeToolAvailability`). */
107
+ available: boolean;
108
+ /**
109
+ * Причина недоступности: `mode` (переключить режим), `role` (делегировать),
110
+ * `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
111
+ * `dependency` (в окружении нет нужной программы — git/rg/sh),
112
+ * `workspace` (не задан рабочий каталог проекта).
113
+ */
114
+ reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace';
115
+ /** ADR-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
116
+ source: 'built-in';
117
+ /** ADR-071 §2.6: длина `JSON.stringify` LLM-определения тула (как слой `tools`). */
118
+ chars?: number;
119
+ /** ADR-071 §2.6: оценка токенов (`ceil(chars / ratio)`) — значение оценочное. */
120
+ estTokens?: number;
121
+ /** ADR-071 §2.6: chars-per-token, применённый к оценке (4 — без калибровки). */
122
+ ratio?: number;
123
+ /** ADR-071 §2.6: тул жёстко отключён администратором (`tools.disabled`). */
124
+ adminDisabled?: boolean;
125
+ }
126
+ /** ADR-071 §2.6: строка тула MCP-сервера с оценкой токенов. */
127
+ export interface McpToolDetail {
128
+ name: string;
129
+ /** Длина `JSON.stringify` LLM-определения тула (имя с префиксом сервера). */
130
+ chars: number;
131
+ estTokens: number;
132
+ ratio: number;
133
+ /** ADR-071 §2.6: тул отключён администратором (`tools.disabled`). */
134
+ adminDisabled?: boolean;
135
+ }
136
+ /** ADR-070 §2.5: state-сообщения истории, сгруппированные по типу. */
137
+ export interface PromptHistoryStateMessage {
138
+ type: string;
139
+ count: number;
140
+ chars: number;
141
+ estTokens: number;
142
+ }
143
+ /** ADR-070 §2.5: состав слоя истории (`messages`), зеркалит реальную отправку. */
144
+ export interface PromptHistoryInfo {
145
+ /** Реально отправляемые сообщения (после фильтрации), суммарно. */
146
+ messages: {
147
+ count: number;
148
+ chars: number;
149
+ estTokens: number;
150
+ };
151
+ /** Chronological state-сообщения (mode_change/agent_switch/plan_updated/todos_updated/…), сгруппированы по type. */
152
+ stateMessages: PromptHistoryStateMessage[];
153
+ /** Что НЕ уходит в LLM. */
154
+ excluded: {
155
+ disabled: number;
156
+ hidden: number;
157
+ info: number;
158
+ };
159
+ /** Мультимодальные части (не text). */
160
+ attachments: {
161
+ count: number;
162
+ chars: number;
163
+ };
164
+ /** Число плейсхолдеров секретов ⟦SYNTH_SECRET_N⟧ в отправляемых сообщениях (ADR-036). */
165
+ secretPlaceholders: number;
166
+ }
167
+ /**
168
+ * Статистика по агенту в рамках сессии (`GET /sessions/:id/stats`).
169
+ * Итоги (`input_tokens`/`output_tokens`/`cache_*`/`reasoning_tokens`/`cost_usd`)
170
+ * включают usage/cost сабагентов (own + все потомки); `subagent_*` — детализация
171
+ * только по дочерним сессиям (tool `task`), инициированным агентом.
172
+ */
173
+ export interface SessionAgentStats {
174
+ agent_role: string;
175
+ messages: number;
176
+ input_tokens: number;
177
+ output_tokens: number;
178
+ cache_read_tokens: number;
179
+ cache_write_tokens: number;
180
+ reasoning_tokens: number;
181
+ /**
182
+ * Номинальная сумма всех валют (обратная совместимость). Мультивалютная
183
+ * разбивка — в `cost_by_currency`; здесь значение равно её сумме.
184
+ */
185
+ cost_usd: number;
186
+ /** Разбивка стоимости по валютам (код валюты → сумма, напр. `{ USD: 0.5, RUB: 42 }`). */
187
+ cost_by_currency?: Record<string, number>;
188
+ /** cache_read / input (0 при input = 0). */
189
+ cache_hit_rate: number;
190
+ duration_ms: number;
191
+ /** output_tokens / (duration_ms / 1000); 0 при отсутствии длительности. */
192
+ output_tps: number;
193
+ subagent_sessions: number;
194
+ subagent_tokens: number;
195
+ }
196
+ /** Статистика по автору user-сообщений (атрибуция usage последующего ответа). */
197
+ export interface SessionUserStats {
198
+ author: string;
199
+ /** Display name профиля автора; при отсутствии профиля/имени — не задаётся. */
200
+ display_name?: string;
201
+ messages: number;
202
+ input_tokens: number;
203
+ output_tokens: number;
204
+ cache_read_tokens: number;
205
+ cache_write_tokens: number;
206
+ reasoning_tokens: number;
207
+ cost_usd: number;
208
+ /** Разбивка стоимости по валютам (код валюты → сумма). */
209
+ cost_by_currency?: Record<string, number>;
210
+ cache_hit_rate: number;
211
+ }
212
+ /**
213
+ * Сводка по сабагентам сессии (рекурсивно, tool `task`). Отдельный блок:
214
+ * `SessionAgentStats` уже включает usage детей в свои итоги, а здесь — только
215
+ * суммарная детализация по всем дочерним сессиям (в контекстное окно родителя
216
+ * их usage не входит, ADR-070 §2.6).
217
+ */
218
+ export interface SessionSubagentStats {
219
+ sessions: number;
220
+ input_tokens: number;
221
+ output_tokens: number;
222
+ cache_read_tokens: number;
223
+ cache_write_tokens: number;
224
+ reasoning_tokens: number;
225
+ cost_usd: number;
226
+ /** Разбивка стоимости по валютам (код валюты → сумма). */
227
+ cost_by_currency?: Record<string, number>;
228
+ }
229
+ /** Ответ `GET /api/v2/sessions/:id/stats`. */
230
+ export interface SessionStats {
231
+ session_id: string;
232
+ agents: SessionAgentStats[];
233
+ users: SessionUserStats[];
234
+ /** Суммарная статистика дочерних сессий сабагентов (отдельно от ответа). */
235
+ subagents: SessionSubagentStats;
236
+ }
@@ -0,0 +1,15 @@
1
+ // --- Оценка токенов по символам (ADR-071 §2.6) ---
2
+ /** Дефолтный chars-per-token, если калибровки для модели нет. */
3
+ export const DEFAULT_CHARS_PER_TOKEN = 4;
4
+ /**
5
+ * Нижняя граница разумного chars-per-token (аномальные семплы отбрасываются).
6
+ * CJK/эффективные BPE дают ~1–2 символа на токен, поэтому допускаем 1.5.
7
+ */
8
+ export const MIN_CHARS_PER_TOKEN = 1.5;
9
+ /**
10
+ * Верхняя граница разумного chars-per-token. Берётся с запасом: «эффективные»
11
+ * токенизаторы (например, `omn.qwen3.8:27b`) дают ratio ≈ 11.7.
12
+ */
13
+ export const MAX_CHARS_PER_TOKEN = 16;
14
+ /** Минимальный `usage.inputTokens` для калибровки — меньшие значения шумные. */
15
+ export const MIN_CALIBRATION_INPUT_TOKENS = 500;
@@ -0,0 +1,84 @@
1
+ /** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
2
+ export declare const CURRENCIES: readonly ["RUB", "USD", "CNY"];
3
+ export type Currency = (typeof CURRENCIES)[number];
4
+ /** Проверка, что значение — допустимая валюта (RUB/USD/CNY). */
5
+ export declare function isCurrency(value: unknown): value is Currency;
6
+ /** Ленивый разбор валюты: неизвестное значение → undefined. */
7
+ export declare function parseCurrency(value: unknown): Currency | undefined;
8
+ /** Результат строгого разбора поля `currency` из тела запроса. */
9
+ export type CurrencyInputResult = {
10
+ ok: true;
11
+ currency: Currency | undefined;
12
+ } | {
13
+ ok: false;
14
+ };
15
+ /**
16
+ * Строгий разбор поля `currency`:
17
+ * - `undefined` — поле не передано (сохранить existing);
18
+ * - `null`/`''` — явно очистить (undefined);
19
+ * - валидная валюта — принять;
20
+ * - иная непустая строка — ошибка (`ok: false`), чтобы не терять значение молча.
21
+ */
22
+ export declare function parseCurrencyInput(raw: unknown, existing?: Currency): CurrencyInputResult;
23
+ /** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
24
+ export declare function hasPriceInput(body: unknown): boolean;
25
+ export interface ProviderConfig {
26
+ name: string;
27
+ type: string;
28
+ baseUrl?: string;
29
+ apiKey?: string;
30
+ defaultModel?: string;
31
+ timeout?: number;
32
+ enabled?: boolean;
33
+ icon?: string;
34
+ /** Валюта по умолчанию для моделей провайдера. Отсутствует → USD. */
35
+ currency?: Currency;
36
+ /**
37
+ * Размер контекстного окна провайдера (`num_ctx` Ollama). Опционально;
38
+ * приоритетнее `ModelConfig.contextWindow`. Применяется только нативным
39
+ * путём Ollama (`/api/chat`).
40
+ */
41
+ numCtx?: number;
42
+ }
43
+ export type ContextSource = 'api' | 'reference' | 'manual' | 'unknown';
44
+ /**
45
+ * Источник цен модели: `api` — получены синхронизацией с провайдером,
46
+ * `manual` — заданы пользователем вручную, `unknown` — не определены.
47
+ */
48
+ export type PriceSource = 'api' | 'manual' | 'unknown';
49
+ export type ContextCategory = 'user' | 'role' | 'system';
50
+ export interface ContextFileInfo {
51
+ filename: string;
52
+ isSystem: boolean;
53
+ isOverridden: boolean;
54
+ category: ContextCategory;
55
+ size: number;
56
+ modifiedAt?: number;
57
+ enabled?: boolean;
58
+ }
59
+ export interface ContextFileContent {
60
+ filename: string;
61
+ content: string;
62
+ isSystem: boolean;
63
+ isOverridden: boolean;
64
+ category: ContextCategory;
65
+ }
66
+ export interface ModelConfig {
67
+ id: string;
68
+ name: string;
69
+ provider: string;
70
+ description?: string;
71
+ enabled: boolean;
72
+ isDefault?: boolean;
73
+ contextWindow?: number;
74
+ contextSource?: ContextSource;
75
+ maxOutputTokens?: number;
76
+ inputPrice?: number;
77
+ outputPrice?: number;
78
+ cacheReadPrice?: number;
79
+ cacheWritePrice?: number;
80
+ /** Откуда взяты цены: `api` — синхронизация, `manual` — ручной ввод. */
81
+ priceSource?: PriceSource;
82
+ /** Валюта цен модели; отсутствует → валюта провайдера → USD. */
83
+ currency?: Currency;
84
+ }
@@ -0,0 +1,35 @@
1
+ // --- Currency ---
2
+ /** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
3
+ export const CURRENCIES = ['RUB', 'USD', 'CNY'];
4
+ /** Проверка, что значение — допустимая валюта (RUB/USD/CNY). */
5
+ export function isCurrency(value) {
6
+ return typeof value === 'string' && CURRENCIES.includes(value);
7
+ }
8
+ /** Ленивый разбор валюты: неизвестное значение → undefined. */
9
+ export function parseCurrency(value) {
10
+ return isCurrency(value) ? value : undefined;
11
+ }
12
+ /**
13
+ * Строгий разбор поля `currency`:
14
+ * - `undefined` — поле не передано (сохранить existing);
15
+ * - `null`/`''` — явно очистить (undefined);
16
+ * - валидная валюта — принять;
17
+ * - иная непустая строка — ошибка (`ok: false`), чтобы не терять значение молча.
18
+ */
19
+ export function parseCurrencyInput(raw, existing) {
20
+ if (raw === null || raw === '')
21
+ return { ok: true, currency: undefined };
22
+ if (raw === undefined)
23
+ return { ok: true, currency: existing };
24
+ return isCurrency(raw) ? { ok: true, currency: raw } : { ok: false };
25
+ }
26
+ /** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
27
+ export function hasPriceInput(body) {
28
+ if (!body || typeof body !== 'object')
29
+ return false;
30
+ const b = body;
31
+ return 'input_price' in b || 'inputPrice' in b
32
+ || 'output_price' in b || 'outputPrice' in b
33
+ || 'cache_read_price' in b || 'cacheReadPrice' in b
34
+ || 'cache_write_price' in b || 'cacheWritePrice' in b;
35
+ }