@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,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-102: аналитика и отчётность инстанса — контракт пред-агрегированных
|
|
3
|
+
* суточных роллапов.
|
|
4
|
+
*
|
|
5
|
+
* Единица роллапа — **сутки в UTC**. Хранилище держит **сырые счётчики**
|
|
6
|
+
* (`measures` + `costByCurrency`); дериваты (`cache_hit_rate`, `output_tps`,
|
|
7
|
+
* итоги по валютам) считает сервис на чтении. Роллапы агрегированы: текстов
|
|
8
|
+
* сообщений, содержимого промптов, ключей и PII в значениях нет.
|
|
9
|
+
*/
|
|
10
|
+
/** Семейства роллапов (PROP-102 §2). */
|
|
11
|
+
export declare const ANALYTICS_FAMILIES: readonly ["usage", "activity", "decision", "prompt"];
|
|
12
|
+
export type AnalyticsFamily = (typeof ANALYTICS_FAMILIES)[number];
|
|
13
|
+
/**
|
|
14
|
+
* Оси измерений роллапа. Короткие ключи `dimensions`; `day` — отдельное поле
|
|
15
|
+
* бакета (`AnalyticsRollupBucket.day`), но участвует в фильтрах и группировке.
|
|
16
|
+
*/
|
|
17
|
+
export declare const ANALYTICS_DIMENSIONS: readonly ["day", "user", "project", "model", "agent", "provider"];
|
|
18
|
+
export type AnalyticsDimension = (typeof ANALYTICS_DIMENSIONS)[number];
|
|
19
|
+
/**
|
|
20
|
+
* Известные меры по семействам. Имена — snake_case (как в `sessions/stats.ts`:
|
|
21
|
+
* `input_tokens`/`output_tokens`/`cost_usd`/…). Список — подсказка/валидация
|
|
22
|
+
* уровня домена: хранилище неизвестные числовые меры не отбрасывает.
|
|
23
|
+
*/
|
|
24
|
+
export declare const ANALYTICS_MEASURES_BY_FAMILY: {
|
|
25
|
+
readonly usage: readonly ["input_tokens", "output_tokens", "cache_read_tokens", "cache_write_tokens", "reasoning_tokens", "requests", "messages", "duration_ms"];
|
|
26
|
+
readonly activity: readonly ["sessions_created", "sessions_archived", "messages_user", "messages_assistant", "messages_tool", "tool_calls", "errors", "aborts", "turns"];
|
|
27
|
+
readonly decision: readonly ["calls", "handled", "fallback", "escalated", "attempts", "rejected"];
|
|
28
|
+
readonly prompt: readonly [];
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* Пред-агрегированный бакет роллапа. Ключ — `(family, day, dimensions)`
|
|
32
|
+
* (измерения в отсортированном порядке). `increment` — upsert с суммированием,
|
|
33
|
+
* `set` — точная перезапись.
|
|
34
|
+
*/
|
|
35
|
+
export interface AnalyticsRollupBucket {
|
|
36
|
+
family: AnalyticsFamily;
|
|
37
|
+
/** Сутки UTC в формате `YYYY-MM-DD`. */
|
|
38
|
+
day: string;
|
|
39
|
+
/** Значения осей (короткие ключи `AnalyticsDimension`); `day` — отдельное поле. */
|
|
40
|
+
dimensions: Record<string, string>;
|
|
41
|
+
/** Сырые счётчики (snake_case); неизвестные меры сохраняются как есть. */
|
|
42
|
+
measures: Record<string, number>;
|
|
43
|
+
/** Разбивка стоимости по валютам; пустая — поле опускается. */
|
|
44
|
+
costByCurrency?: Record<string, number>;
|
|
45
|
+
}
|
|
46
|
+
/** Запрос среза/серии роллапов: фильтры (семейство/период/оси) + группировка. */
|
|
47
|
+
export interface AnalyticsRollupQuery {
|
|
48
|
+
family: AnalyticsFamily;
|
|
49
|
+
/** Начало периода включительно (`YYYY-MM-DD`, сравнение по строке). */
|
|
50
|
+
from?: string;
|
|
51
|
+
/** Конец периода включительно (`YYYY-MM-DD`). */
|
|
52
|
+
to?: string;
|
|
53
|
+
/** Фильтр по равенству значений осей; для `day` — сравнение с `bucket.day`. */
|
|
54
|
+
dimensions?: Partial<Record<AnalyticsDimension, string>>;
|
|
55
|
+
/** Оси группировки; пусто/не задано — одна итоговая строка (`dimensions: {}`). */
|
|
56
|
+
groupBy?: AnalyticsDimension[];
|
|
57
|
+
}
|
|
58
|
+
/** Строка агрегированного ответа: значения осей группировки + суммы мер. */
|
|
59
|
+
export interface AnalyticsRollupRow {
|
|
60
|
+
/** Значения осей группировки (пусто — итог). */
|
|
61
|
+
dimensions: Record<string, string>;
|
|
62
|
+
measures: Record<string, number>;
|
|
63
|
+
/** Разбивка стоимости по валютам; пустая — поле опускается. */
|
|
64
|
+
costByCurrency?: Record<string, number>;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Дериваты, которые сервис считает **на чтении** из сырых счётчиков (не
|
|
68
|
+
* персистятся, PROP-102 §2). В строке отчёта лежат рядом с сырыми мерами; при
|
|
69
|
+
* экспорте выносятся отдельными колонками после сырых мер.
|
|
70
|
+
*/
|
|
71
|
+
export declare const ANALYTICS_DERIVED_MEASURES: readonly ["total_tokens", "cache_hit_rate", "reasoning_ratio", "output_tps"];
|
|
72
|
+
export type AnalyticsDerivedMeasure = (typeof ANALYTICS_DERIVED_MEASURES)[number];
|
|
73
|
+
/** Идентификатор отчёта — совпадает с семейством роллапов (PROP-102 §4). */
|
|
74
|
+
export type AnalyticsReportKind = AnalyticsFamily;
|
|
75
|
+
/** Строка отчёта: оси группировки + меры (в т.ч. дериваты) + стоимость. */
|
|
76
|
+
export interface AnalyticsReportRow {
|
|
77
|
+
/** Значения осей группировки (пусто — итог). */
|
|
78
|
+
dimensions: Record<string, string>;
|
|
79
|
+
/** Меры: сырые счётчики + дериваты (`ANALYTICS_DERIVED_MEASURES`). */
|
|
80
|
+
measures: Record<string, number>;
|
|
81
|
+
/** Разбивка стоимости по валютам; пустая — поле опускается. */
|
|
82
|
+
costByCurrency?: Record<string, number>;
|
|
83
|
+
}
|
|
84
|
+
/** Отчёт по семейству за период (только чтение, PROP-102 §4). */
|
|
85
|
+
export interface AnalyticsReport {
|
|
86
|
+
report: AnalyticsReportKind;
|
|
87
|
+
/** Начало периода включительно (`YYYY-MM-DD`, UTC). */
|
|
88
|
+
from: string;
|
|
89
|
+
/** Конец периода включительно (`YYYY-MM-DD`, UTC). */
|
|
90
|
+
to: string;
|
|
91
|
+
/** Оси группировки (порядок важен для экспорта). */
|
|
92
|
+
groupBy: AnalyticsDimension[];
|
|
93
|
+
rows: AnalyticsReportRow[];
|
|
94
|
+
}
|
|
95
|
+
/** Формат выгрузки отчёта (server-side, только данные — PROP-102 §6). */
|
|
96
|
+
export declare const ANALYTICS_EXPORT_FORMATS: readonly ["csv", "json"];
|
|
97
|
+
export type AnalyticsExportFormat = (typeof ANALYTICS_EXPORT_FORMATS)[number];
|
|
98
|
+
/**
|
|
99
|
+
* Сводка инстанса за период: агрегаты по семействам (меры usage с дериватами,
|
|
100
|
+
* меры activity и decision — своими словарями). Без персональных данных.
|
|
101
|
+
*/
|
|
102
|
+
export interface AnalyticsSummary {
|
|
103
|
+
from: string;
|
|
104
|
+
to: string;
|
|
105
|
+
/** Меры `usage` (в т.ч. дериваты) — итог по периоду. */
|
|
106
|
+
usage: Record<string, number>;
|
|
107
|
+
/** Меры `activity` — итог по периоду. */
|
|
108
|
+
activity: Record<string, number>;
|
|
109
|
+
/** Меры `decision` — итог по периоду. */
|
|
110
|
+
decision: Record<string, number>;
|
|
111
|
+
/** Итоговая стоимость по валютам; пустая — поле опускается. */
|
|
112
|
+
costByCurrency?: Record<string, number>;
|
|
113
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-102: аналитика и отчётность инстанса — контракт пред-агрегированных
|
|
3
|
+
* суточных роллапов.
|
|
4
|
+
*
|
|
5
|
+
* Единица роллапа — **сутки в UTC**. Хранилище держит **сырые счётчики**
|
|
6
|
+
* (`measures` + `costByCurrency`); дериваты (`cache_hit_rate`, `output_tps`,
|
|
7
|
+
* итоги по валютам) считает сервис на чтении. Роллапы агрегированы: текстов
|
|
8
|
+
* сообщений, содержимого промптов, ключей и PII в значениях нет.
|
|
9
|
+
*/
|
|
10
|
+
/** Семейства роллапов (PROP-102 §2). */
|
|
11
|
+
export const ANALYTICS_FAMILIES = ['usage', 'activity', 'decision', 'prompt'];
|
|
12
|
+
/**
|
|
13
|
+
* Оси измерений роллапа. Короткие ключи `dimensions`; `day` — отдельное поле
|
|
14
|
+
* бакета (`AnalyticsRollupBucket.day`), но участвует в фильтрах и группировке.
|
|
15
|
+
*/
|
|
16
|
+
export const ANALYTICS_DIMENSIONS = ['day', 'user', 'project', 'model', 'agent', 'provider'];
|
|
17
|
+
/**
|
|
18
|
+
* Известные меры по семействам. Имена — snake_case (как в `sessions/stats.ts`:
|
|
19
|
+
* `input_tokens`/`output_tokens`/`cost_usd`/…). Список — подсказка/валидация
|
|
20
|
+
* уровня домена: хранилище неизвестные числовые меры не отбрасывает.
|
|
21
|
+
*/
|
|
22
|
+
export const ANALYTICS_MEASURES_BY_FAMILY = {
|
|
23
|
+
usage: [
|
|
24
|
+
'input_tokens',
|
|
25
|
+
'output_tokens',
|
|
26
|
+
'cache_read_tokens',
|
|
27
|
+
'cache_write_tokens',
|
|
28
|
+
'reasoning_tokens',
|
|
29
|
+
'requests',
|
|
30
|
+
'messages',
|
|
31
|
+
'duration_ms',
|
|
32
|
+
],
|
|
33
|
+
activity: [
|
|
34
|
+
'sessions_created',
|
|
35
|
+
'sessions_archived',
|
|
36
|
+
'messages_user',
|
|
37
|
+
'messages_assistant',
|
|
38
|
+
'messages_tool',
|
|
39
|
+
'tool_calls',
|
|
40
|
+
'errors',
|
|
41
|
+
'aborts',
|
|
42
|
+
'turns',
|
|
43
|
+
],
|
|
44
|
+
// Персистентная замена in-memory снимка `decisionMetrics` (ADR-084); модель — ось, `by_model` не дублируется.
|
|
45
|
+
decision: ['calls', 'handled', 'fallback', 'escalated', 'attempts', 'rejected'],
|
|
46
|
+
// `prompt` — производные от `usage` (`cache_hit_rate`, доля reasoning, output tps): отдельной записи не требует.
|
|
47
|
+
prompt: [],
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* Дериваты, которые сервис считает **на чтении** из сырых счётчиков (не
|
|
51
|
+
* персистятся, PROP-102 §2). В строке отчёта лежат рядом с сырыми мерами; при
|
|
52
|
+
* экспорте выносятся отдельными колонками после сырых мер.
|
|
53
|
+
*/
|
|
54
|
+
export const ANALYTICS_DERIVED_MEASURES = [
|
|
55
|
+
'total_tokens',
|
|
56
|
+
'cache_hit_rate',
|
|
57
|
+
'reasoning_ratio',
|
|
58
|
+
'output_tps',
|
|
59
|
+
];
|
|
60
|
+
/** Формат выгрузки отчёта (server-side, только данные — PROP-102 §6). */
|
|
61
|
+
export const ANALYTICS_EXPORT_FORMATS = ['csv', 'json'];
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.moved' | 'project.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.chunk' | 'stream.usage' | 'stream.done' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'message.queued' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'error';
|
|
2
|
+
export interface BusEvent {
|
|
3
|
+
type: EventType;
|
|
4
|
+
sessionId: string;
|
|
5
|
+
data: Record<string, unknown>;
|
|
6
|
+
timestamp: string;
|
|
7
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
package/dist/types/commands.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import type { SkillScope, SkillLevel } from './skills.js';
|
|
2
2
|
import type { PermissionConfig } from './permission.js';
|
|
3
3
|
/**
|
|
4
|
-
*
|
|
4
|
+
* ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
|
|
5
5
|
* бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
|
|
6
6
|
*/
|
|
7
|
-
/** Вид команды (
|
|
7
|
+
/** Вид команды (ADR-046 §7.2). */
|
|
8
8
|
export declare const COMMAND_KINDS: readonly ["builtin", "template", "skill", "bundle"];
|
|
9
9
|
export type CommandKind = (typeof COMMAND_KINDS)[number];
|
|
10
10
|
/** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
|
|
@@ -17,7 +17,7 @@ export type CommandActor = (typeof COMMAND_ACTORS)[number];
|
|
|
17
17
|
export type CommandDiagnosticLevel = 'error' | 'warning' | 'info';
|
|
18
18
|
/** Коды диагностики команд/бандлов (только реально эмитируемые). */
|
|
19
19
|
export type CommandIssueCode = 'invalid-frontmatter' | 'missing-name' | 'shadowed' | 'collision' | 'invalid-bundle' | 'missing-skill' | 'read-error'
|
|
20
|
-
/**
|
|
20
|
+
/** ADR-046 §4.4/§7.1: проектный каталог недоверенный — команда не грузится. */
|
|
21
21
|
| 'untrusted';
|
|
22
22
|
/** Диагностика реестра команд (видна в `GET /api/v2/commands?diagnostics=1`). */
|
|
23
23
|
export interface CommandDiagnostic {
|
|
@@ -30,7 +30,7 @@ export interface CommandDiagnostic {
|
|
|
30
30
|
path?: string;
|
|
31
31
|
}
|
|
32
32
|
/**
|
|
33
|
-
* YAML-группа скиллов (
|
|
33
|
+
* YAML-группа скиллов (ADR-046 §7.3). `/bundle-name` грузит N тел одним
|
|
34
34
|
* сообщением; bundle побеждает одноимённый skill.
|
|
35
35
|
*/
|
|
36
36
|
export interface SkillBundle {
|
|
@@ -59,7 +59,7 @@ export interface CommandSummary {
|
|
|
59
59
|
/** Статус результата резолвинга команды. */
|
|
60
60
|
export type CommandResolveStatus = 'builtin' | 'prompt' | 'template' | 'skill' | 'bundle' | 'summarization' | 'unknown' | 'denied' | 'unavailable';
|
|
61
61
|
/**
|
|
62
|
-
* Результат резолвинга `/`-команды (
|
|
62
|
+
* Результат резолвинга `/`-команды (ADR-046 §7.1).
|
|
63
63
|
*
|
|
64
64
|
* - `builtin` — локальный ответ (`output`), LLM не вызывается; user+assistant
|
|
65
65
|
* сообщения помечаются `ephemeral` и исключаются из LLM-контекста;
|
|
@@ -87,14 +87,14 @@ export interface CommandResolveResult {
|
|
|
87
87
|
/** Причина denied/unavailable. */
|
|
88
88
|
message?: string;
|
|
89
89
|
}
|
|
90
|
-
/**
|
|
90
|
+
/** ADR-046 §7.4: результат исполнения inline shell (`` !`cmd` ``). */
|
|
91
91
|
export interface CommandShellResult {
|
|
92
92
|
output: string;
|
|
93
93
|
isError: boolean;
|
|
94
94
|
}
|
|
95
95
|
/**
|
|
96
|
-
*
|
|
97
|
-
* само проходит `PermissionEvaluator` (
|
|
96
|
+
* ADR-046 §7.4: раннер inline shell. Оркестратор передаёт замыкание, которое
|
|
97
|
+
* само проходит `PermissionEvaluator` (ADR-029) и исполняет команду; сервис
|
|
98
98
|
* команд только вызывает его для подстановки `` !`cmd` ``.
|
|
99
99
|
*/
|
|
100
100
|
export type CommandShellRunner = (command: string) => Promise<CommandShellResult>;
|
|
@@ -109,11 +109,11 @@ export interface CommandRuntimeOpts {
|
|
|
109
109
|
sessionEnabled?: string[];
|
|
110
110
|
sessionDisabled?: string[];
|
|
111
111
|
permissionConfig?: PermissionConfig;
|
|
112
|
-
/**
|
|
112
|
+
/** ADR-046 §7.4: раннер inline shell (только при включённом `skills.inlineShell`). */
|
|
113
113
|
runShell?: CommandShellRunner;
|
|
114
114
|
}
|
|
115
115
|
/**
|
|
116
|
-
*
|
|
116
|
+
* ADR-046 §7.3: рантайм-контракт команд для оркестратора/CLI. Структурно
|
|
117
117
|
* реализуется `CommandService`; прокидывается в `OrchestratorOptions`.
|
|
118
118
|
*/
|
|
119
119
|
export interface CommandRuntime {
|
package/dist/types/commands.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
|
|
3
3
|
* бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
|
|
4
4
|
*/
|
|
5
|
-
/** Вид команды (
|
|
5
|
+
/** Вид команды (ADR-046 §7.2). */
|
|
6
6
|
export const COMMAND_KINDS = ['builtin', 'template', 'skill', 'bundle'];
|
|
7
7
|
/** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
|
|
8
8
|
export const COMMAND_CONFLICT_MODES = ['bundle-wins', 'conservative', 'namespace'];
|
package/dist/types/decision.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-084: decision-модели (System One: Clef/Jev/Decision-1/…) как единый
|
|
3
3
|
* примитив — `state` (текст/JSON) + типизированные вопросы → вероятности за
|
|
4
4
|
* один forward-pass. Здесь только контракты без бизнес-логики: сами адаптеры и
|
|
5
5
|
* вызовы живут в core (`providers/decision.ts`, `GatewayProvider.decide`).
|
|
@@ -16,7 +16,7 @@ export type DecisionQuestionType = 'noul' | 'choice' | 'score';
|
|
|
16
16
|
export declare const DECISION_CRITERIA_MIN = 2;
|
|
17
17
|
export declare const DECISION_CRITERIA_MAX = 26;
|
|
18
18
|
/**
|
|
19
|
-
*
|
|
19
|
+
* ADR-084: бинарный вопрос. `criteria` — подписи веток `true`/`false` (опц.),
|
|
20
20
|
* `instructions` — пояснение для модели (опц.).
|
|
21
21
|
*/
|
|
22
22
|
export interface DecisionNoulQuestion {
|
|
@@ -27,33 +27,33 @@ export interface DecisionNoulQuestion {
|
|
|
27
27
|
false?: string;
|
|
28
28
|
};
|
|
29
29
|
}
|
|
30
|
-
/**
|
|
30
|
+
/** ADR-084: вопрос-выбор. `criteria` — карта «вариант → пояснение|null» (2..26). */
|
|
31
31
|
export interface DecisionChoiceQuestion {
|
|
32
32
|
type: 'choice';
|
|
33
33
|
instructions: string;
|
|
34
34
|
criteria: Record<string, string | null>;
|
|
35
35
|
}
|
|
36
|
-
/**
|
|
36
|
+
/** ADR-084: вопрос-шкала. `criteria` — упорядоченный список позиций (2..26). */
|
|
37
37
|
export interface DecisionScoreQuestion {
|
|
38
38
|
type: 'score';
|
|
39
39
|
instructions: string;
|
|
40
40
|
criteria: string[];
|
|
41
41
|
}
|
|
42
|
-
/**
|
|
42
|
+
/** ADR-084: типизированный вопрос decision-модели. */
|
|
43
43
|
export type DecisionQuestion = DecisionNoulQuestion | DecisionChoiceQuestion | DecisionScoreQuestion;
|
|
44
|
-
/**
|
|
44
|
+
/** ADR-084: ответ на `noul` — вероятность «да» (`0..1`). */
|
|
45
45
|
export interface DecisionNoulAnswer {
|
|
46
46
|
type: 'noul';
|
|
47
47
|
noul: number;
|
|
48
48
|
}
|
|
49
|
-
/**
|
|
49
|
+
/** ADR-084: ответ на `choice` — выбранный вариант + вероятности по всем. */
|
|
50
50
|
export interface DecisionChoiceAnswer {
|
|
51
51
|
type: 'choice';
|
|
52
52
|
choice: string;
|
|
53
53
|
confidence: number;
|
|
54
54
|
probabilities: Record<string, number>;
|
|
55
55
|
}
|
|
56
|
-
/**
|
|
56
|
+
/** ADR-084: ответ на `score` — позиция на шкале + вероятности по всем. */
|
|
57
57
|
export interface DecisionScoreAnswer {
|
|
58
58
|
type: 'score';
|
|
59
59
|
score: number;
|
|
@@ -62,10 +62,10 @@ export interface DecisionScoreAnswer {
|
|
|
62
62
|
/** Подписи позиций шкалы (если модель/провайдер их отдаёт). */
|
|
63
63
|
legend?: Record<string, string>;
|
|
64
64
|
}
|
|
65
|
-
/**
|
|
65
|
+
/** ADR-084: типизированный ответ decision-модели. */
|
|
66
66
|
export type DecisionAnswer = DecisionNoulAnswer | DecisionChoiceAnswer | DecisionScoreAnswer;
|
|
67
67
|
/**
|
|
68
|
-
*
|
|
68
|
+
* ADR-084: медиа-вложения decision-запроса (PROP-085 задел). Источник изображений/
|
|
69
69
|
* видео — мультимодальный ввод (пока не реализован), здесь только контракт-
|
|
70
70
|
* plumbing: значения прокидываются в тело decision-запроса, если непусты.
|
|
71
71
|
*/
|
|
@@ -73,19 +73,19 @@ export interface DecisionMediaInput {
|
|
|
73
73
|
images?: string[];
|
|
74
74
|
videos?: string[];
|
|
75
75
|
}
|
|
76
|
-
/**
|
|
76
|
+
/** ADR-084: запрос `state + questions → answers`. */
|
|
77
77
|
export interface DecisionRequest extends DecisionMediaInput {
|
|
78
78
|
model: string;
|
|
79
79
|
/** Текст или JSON-совместимая структура (System One понимает оба). */
|
|
80
80
|
state: unknown;
|
|
81
81
|
questions: Record<string, DecisionQuestion>;
|
|
82
82
|
}
|
|
83
|
-
/**
|
|
83
|
+
/** ADR-084: расход токенов decision-запроса (snake_case — как у провайдеров). */
|
|
84
84
|
export interface DecisionUsage {
|
|
85
85
|
input_tokens: number;
|
|
86
86
|
output_tokens: number;
|
|
87
87
|
}
|
|
88
|
-
/**
|
|
88
|
+
/** ADR-084: ответ decision-модели. */
|
|
89
89
|
export interface DecisionResponse {
|
|
90
90
|
id?: string;
|
|
91
91
|
model?: string;
|
|
@@ -93,7 +93,7 @@ export interface DecisionResponse {
|
|
|
93
93
|
usage?: DecisionUsage;
|
|
94
94
|
}
|
|
95
95
|
/**
|
|
96
|
-
*
|
|
96
|
+
* ADR-084: универсальная схема вопроса. Границы `choice`/`score` (2..26)
|
|
97
97
|
* проверяются отдельно — иначе `discriminatedUnion` не принимает
|
|
98
98
|
* `ZodEffects`-обёртки внутри вариантов.
|
|
99
99
|
*/
|
|
@@ -224,7 +224,7 @@ export declare const decisionScoreAnswerSchema: z.ZodObject<{
|
|
|
224
224
|
probabilities: Record<string, number>;
|
|
225
225
|
legend?: Record<string, string> | undefined;
|
|
226
226
|
}>;
|
|
227
|
-
/**
|
|
227
|
+
/** ADR-084: схема ответа decision-модели. */
|
|
228
228
|
export declare const decisionAnswerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
|
|
229
229
|
type: z.ZodLiteral<"noul">;
|
|
230
230
|
noul: z.ZodNumber;
|
|
@@ -353,7 +353,7 @@ export declare const decisionRequestSchema: z.ZodObject<{
|
|
|
353
353
|
instructions: string;
|
|
354
354
|
criteria: string[];
|
|
355
355
|
}>>;
|
|
356
|
-
/**
|
|
356
|
+
/** ADR-084/PROP-085: медиа-вложения (изображения/видео) — опциональны. */
|
|
357
357
|
images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
358
358
|
videos: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
359
359
|
}, "strip", z.ZodTypeAny, {
|
package/dist/types/decision.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* ADR-084: decision-модели (System One: Clef/Jev/Decision-1/…) как единый
|
|
3
3
|
* примитив — `state` (текст/JSON) + типизированные вопросы → вероятности за
|
|
4
4
|
* один forward-pass. Здесь только контракты без бизнес-логики: сами адаптеры и
|
|
5
5
|
* вызовы живут в core (`providers/decision.ts`, `GatewayProvider.decide`).
|
|
@@ -27,7 +27,7 @@ const decisionScoreQuestionSchema = z.object({
|
|
|
27
27
|
criteria: z.array(z.string()),
|
|
28
28
|
});
|
|
29
29
|
/**
|
|
30
|
-
*
|
|
30
|
+
* ADR-084: универсальная схема вопроса. Границы `choice`/`score` (2..26)
|
|
31
31
|
* проверяются отдельно — иначе `discriminatedUnion` не принимает
|
|
32
32
|
* `ZodEffects`-обёртки внутри вариантов.
|
|
33
33
|
*/
|
|
@@ -74,7 +74,7 @@ export const decisionScoreAnswerSchema = z.object({
|
|
|
74
74
|
probabilities: z.record(z.string(), z.number()),
|
|
75
75
|
legend: z.record(z.string(), z.string()).optional(),
|
|
76
76
|
});
|
|
77
|
-
/**
|
|
77
|
+
/** ADR-084: схема ответа decision-модели. */
|
|
78
78
|
export const decisionAnswerSchema = z.discriminatedUnion('type', [
|
|
79
79
|
decisionNoulAnswerSchema,
|
|
80
80
|
decisionChoiceAnswerSchema,
|
|
@@ -84,7 +84,7 @@ export const decisionRequestSchema = z.object({
|
|
|
84
84
|
model: z.string(),
|
|
85
85
|
state: z.unknown(),
|
|
86
86
|
questions: z.record(z.string(), decisionQuestionSchema),
|
|
87
|
-
/**
|
|
87
|
+
/** ADR-084/PROP-085: медиа-вложения (изображения/видео) — опциональны. */
|
|
88
88
|
images: z.array(z.string()).optional(),
|
|
89
89
|
videos: z.array(z.string()).optional(),
|
|
90
90
|
});
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Egress-политика исходящих запросов (web/инструкции/скиллы/webhooks/providers/MCP).
|
|
3
|
+
*
|
|
4
|
+
* Единый формат политики (`mode` + `list` + `exceptions`) используется всеми
|
|
5
|
+
* потребителями; `webhooks` дополнительно поддерживает `mode: 'off'` (dev, без
|
|
6
|
+
* проверок и без требования https). Семантика:
|
|
7
|
+
* - `exceptions` — allow-правила, проверяются **первыми** (точный hostname,
|
|
8
|
+
* `*.suffix`, CIDR/IP); hostname-правило разрешает сразу, CIDR — по резолву;
|
|
9
|
+
* - `deny` + `list` — блок, если хотя бы один resolved-адрес в `list`;
|
|
10
|
+
* - `allow` + `list` — разрешено, если ВСЕ resolved-адреса в `list` (или exception);
|
|
11
|
+
* - `off` (только webhooks) — проверок нет, `requireHttps = false`.
|
|
12
|
+
*
|
|
13
|
+
* Литеральные `localhost`/`*.localhost`/`*.local`/`*.internal` и приватные IP
|
|
14
|
+
* блокируются самой политикой (дефолтный `list`), а не отдельным зашитым списком;
|
|
15
|
+
* exception может их разрешить.
|
|
16
|
+
*
|
|
17
|
+
* Дефолтный `list` — **общий канонический список** `DEFAULT_MCP_PRIVATE_CIDRS`
|
|
18
|
+
* (`types/mcp.ts`): он же — дефолт `mcp.networkPolicy` и встроенный fallback
|
|
19
|
+
* `engine/net/egress-guard.ts`. Списков «заблокированных адресов» в коде больше
|
|
20
|
+
* нет, поэтому расширять блокировки нужно только этот список.
|
|
21
|
+
*/
|
|
22
|
+
export declare const EGRESS_POLICY_MODES: readonly ["deny", "allow"];
|
|
23
|
+
export type EgressPolicyMode = (typeof EGRESS_POLICY_MODES)[number];
|
|
24
|
+
export declare const WEBHOOKS_EGRESS_POLICY_MODES: readonly ["deny", "allow", "off"];
|
|
25
|
+
export type WebhooksEgressPolicyMode = (typeof WEBHOOKS_EGRESS_POLICY_MODES)[number];
|
|
26
|
+
/** Скоупы настраиваемой egress-политики (settings/egress). */
|
|
27
|
+
export declare const EGRESS_POLICY_SCOPES: readonly ["tools", "webhooks"];
|
|
28
|
+
export type EgressPolicyScope = (typeof EGRESS_POLICY_SCOPES)[number];
|
|
29
|
+
/** Политика egress для встроенных инструментов (web_fetch/web_search/…). */
|
|
30
|
+
export interface EgressPolicy {
|
|
31
|
+
mode: EgressPolicyMode;
|
|
32
|
+
/** CIDR/IP/hostname-правила основного списка. */
|
|
33
|
+
list: string[];
|
|
34
|
+
/** Allow-правила-исключения (проверяются первыми). */
|
|
35
|
+
exceptions: string[];
|
|
36
|
+
}
|
|
37
|
+
/** Политика egress для исходящих webhooks (доп. режим `off` — dev). */
|
|
38
|
+
export interface WebhooksEgressPolicy {
|
|
39
|
+
mode: WebhooksEgressPolicyMode;
|
|
40
|
+
list: string[];
|
|
41
|
+
exceptions: string[];
|
|
42
|
+
}
|
|
43
|
+
/** Настройки журнала внешних запросов (аудит egress). */
|
|
44
|
+
export interface EgressLogConfig {
|
|
45
|
+
enabled: boolean;
|
|
46
|
+
/** Срок хранения в днях; `0` — не чистить. */
|
|
47
|
+
retentionDays: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Дефолтная политика встроенных инструментов: deny служебных диапазонов
|
|
51
|
+
* (`DEFAULT_MCP_PRIVATE_CIDRS` — общий канонический список, см. `types/mcp.ts`).
|
|
52
|
+
*/
|
|
53
|
+
export declare const DEFAULT_EGRESS_TOOLS_POLICY: EgressPolicy;
|
|
54
|
+
/**
|
|
55
|
+
* Дефолтная политика webhooks: deny служебных диапазонов (тот же общий список)
|
|
56
|
+
* + обязательный https.
|
|
57
|
+
*/
|
|
58
|
+
export declare const DEFAULT_EGRESS_WEBHOOKS_POLICY: WebhooksEgressPolicy;
|
|
59
|
+
/** Дефолт журнала внешних запросов: включён, хранить 7 дней. */
|
|
60
|
+
export declare const DEFAULT_EGRESS_LOG: EgressLogConfig;
|
|
61
|
+
/** Скоупы (источники) внешних запросов в журнале egress. */
|
|
62
|
+
export declare const EGRESS_REQUEST_SCOPES: readonly ["web_fetch", "web_search", "skills", "instructions", "webhooks", "providers", "mcp"];
|
|
63
|
+
export type EgressRequestScope = (typeof EGRESS_REQUEST_SCOPES)[number];
|
|
64
|
+
export declare const EGRESS_REQUEST_STATUSES: readonly ["allowed", "blocked", "error"];
|
|
65
|
+
export type EgressRequestStatus = (typeof EGRESS_REQUEST_STATUSES)[number];
|
|
66
|
+
/**
|
|
67
|
+
* ADR-099 (D1): фактический маршрут запроса — через прокси, напрямую либо
|
|
68
|
+
* direct-фоллбек после недоступного прокси (`proxy.fallbackDirect`).
|
|
69
|
+
*/
|
|
70
|
+
export declare const EGRESS_REQUEST_VIAS: readonly ["proxy", "direct", "fallback"];
|
|
71
|
+
export type EgressRequestVia = (typeof EGRESS_REQUEST_VIAS)[number];
|
|
72
|
+
/**
|
|
73
|
+
* Запись журнала внешних запросов (append-only, без тел/заголовков).
|
|
74
|
+
* `url` хранится без query/userinfo и обрезается до 2048 символов.
|
|
75
|
+
*/
|
|
76
|
+
export interface EgressRequestLogEntry {
|
|
77
|
+
id: string;
|
|
78
|
+
ts: string;
|
|
79
|
+
scope: EgressRequestScope;
|
|
80
|
+
host: string;
|
|
81
|
+
url: string;
|
|
82
|
+
method?: string;
|
|
83
|
+
status: EgressRequestStatus;
|
|
84
|
+
/** Маршрут запроса (ADR-099 D1): proxy/direct/fallback. */
|
|
85
|
+
via?: EgressRequestVia;
|
|
86
|
+
httpStatus?: number;
|
|
87
|
+
bytes?: number;
|
|
88
|
+
durationMs?: number;
|
|
89
|
+
reason?: string;
|
|
90
|
+
matchedRule?: string;
|
|
91
|
+
sessionId?: string;
|
|
92
|
+
projectId?: string;
|
|
93
|
+
actor?: string;
|
|
94
|
+
}
|
|
95
|
+
/** Скоупы изменений egress-политик/прокси в security-аудите. */
|
|
96
|
+
export declare const SECURITY_AUDIT_SCOPES: readonly ["tools", "webhooks", "mcp", "proxy", "tls"];
|
|
97
|
+
export type SecurityAuditScope = (typeof SECURITY_AUDIT_SCOPES)[number];
|
|
98
|
+
export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset"];
|
|
99
|
+
export type SecurityAuditAction = (typeof SECURITY_AUDIT_ACTIONS)[number];
|
|
100
|
+
/**
|
|
101
|
+
* Запись аудита изменений security-политик (append-only). `before`/`after` —
|
|
102
|
+
* снимки политики до/после операции (`null` для reset — значение не задано).
|
|
103
|
+
*/
|
|
104
|
+
export interface SecurityAuditEntry {
|
|
105
|
+
id: string;
|
|
106
|
+
ts: string;
|
|
107
|
+
actor: string;
|
|
108
|
+
scope: SecurityAuditScope;
|
|
109
|
+
action: SecurityAuditAction;
|
|
110
|
+
source: 'runtime';
|
|
111
|
+
before: unknown;
|
|
112
|
+
after: unknown;
|
|
113
|
+
version: number;
|
|
114
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Egress-политика исходящих запросов (web/инструкции/скиллы/webhooks/providers/MCP).
|
|
3
|
+
*
|
|
4
|
+
* Единый формат политики (`mode` + `list` + `exceptions`) используется всеми
|
|
5
|
+
* потребителями; `webhooks` дополнительно поддерживает `mode: 'off'` (dev, без
|
|
6
|
+
* проверок и без требования https). Семантика:
|
|
7
|
+
* - `exceptions` — allow-правила, проверяются **первыми** (точный hostname,
|
|
8
|
+
* `*.suffix`, CIDR/IP); hostname-правило разрешает сразу, CIDR — по резолву;
|
|
9
|
+
* - `deny` + `list` — блок, если хотя бы один resolved-адрес в `list`;
|
|
10
|
+
* - `allow` + `list` — разрешено, если ВСЕ resolved-адреса в `list` (или exception);
|
|
11
|
+
* - `off` (только webhooks) — проверок нет, `requireHttps = false`.
|
|
12
|
+
*
|
|
13
|
+
* Литеральные `localhost`/`*.localhost`/`*.local`/`*.internal` и приватные IP
|
|
14
|
+
* блокируются самой политикой (дефолтный `list`), а не отдельным зашитым списком;
|
|
15
|
+
* exception может их разрешить.
|
|
16
|
+
*
|
|
17
|
+
* Дефолтный `list` — **общий канонический список** `DEFAULT_MCP_PRIVATE_CIDRS`
|
|
18
|
+
* (`types/mcp.ts`): он же — дефолт `mcp.networkPolicy` и встроенный fallback
|
|
19
|
+
* `engine/net/egress-guard.ts`. Списков «заблокированных адресов» в коде больше
|
|
20
|
+
* нет, поэтому расширять блокировки нужно только этот список.
|
|
21
|
+
*/
|
|
22
|
+
import { DEFAULT_MCP_PRIVATE_CIDRS } from './mcp.js';
|
|
23
|
+
export const EGRESS_POLICY_MODES = ['deny', 'allow'];
|
|
24
|
+
export const WEBHOOKS_EGRESS_POLICY_MODES = ['deny', 'allow', 'off'];
|
|
25
|
+
/** Скоупы настраиваемой egress-политики (settings/egress). */
|
|
26
|
+
export const EGRESS_POLICY_SCOPES = ['tools', 'webhooks'];
|
|
27
|
+
/**
|
|
28
|
+
* Дефолтная политика встроенных инструментов: deny служебных диапазонов
|
|
29
|
+
* (`DEFAULT_MCP_PRIVATE_CIDRS` — общий канонический список, см. `types/mcp.ts`).
|
|
30
|
+
*/
|
|
31
|
+
export const DEFAULT_EGRESS_TOOLS_POLICY = {
|
|
32
|
+
mode: 'deny',
|
|
33
|
+
list: [...DEFAULT_MCP_PRIVATE_CIDRS],
|
|
34
|
+
exceptions: [],
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* Дефолтная политика webhooks: deny служебных диапазонов (тот же общий список)
|
|
38
|
+
* + обязательный https.
|
|
39
|
+
*/
|
|
40
|
+
export const DEFAULT_EGRESS_WEBHOOKS_POLICY = {
|
|
41
|
+
mode: 'deny',
|
|
42
|
+
list: [...DEFAULT_MCP_PRIVATE_CIDRS],
|
|
43
|
+
exceptions: [],
|
|
44
|
+
};
|
|
45
|
+
/** Дефолт журнала внешних запросов: включён, хранить 7 дней. */
|
|
46
|
+
export const DEFAULT_EGRESS_LOG = {
|
|
47
|
+
enabled: true,
|
|
48
|
+
retentionDays: 7,
|
|
49
|
+
};
|
|
50
|
+
/** Скоупы (источники) внешних запросов в журнале egress. */
|
|
51
|
+
export const EGRESS_REQUEST_SCOPES = [
|
|
52
|
+
'web_fetch',
|
|
53
|
+
'web_search',
|
|
54
|
+
'skills',
|
|
55
|
+
'instructions',
|
|
56
|
+
'webhooks',
|
|
57
|
+
'providers',
|
|
58
|
+
'mcp',
|
|
59
|
+
];
|
|
60
|
+
export const EGRESS_REQUEST_STATUSES = ['allowed', 'blocked', 'error'];
|
|
61
|
+
/**
|
|
62
|
+
* ADR-099 (D1): фактический маршрут запроса — через прокси, напрямую либо
|
|
63
|
+
* direct-фоллбек после недоступного прокси (`proxy.fallbackDirect`).
|
|
64
|
+
*/
|
|
65
|
+
export const EGRESS_REQUEST_VIAS = ['proxy', 'direct', 'fallback'];
|
|
66
|
+
/** Скоупы изменений egress-политик/прокси в security-аудите. */
|
|
67
|
+
export const SECURITY_AUDIT_SCOPES = ['tools', 'webhooks', 'mcp', 'proxy', 'tls'];
|
|
68
|
+
export const SECURITY_AUDIT_ACTIONS = ['update', 'reset'];
|