@itphx/synth-shared 0.7.3 → 0.8.2

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 (74) hide show
  1. package/dist/config/defaults.d.ts.map +1 -1
  2. package/dist/config/defaults.js +44 -0
  3. package/dist/config/defaults.js.map +1 -1
  4. package/dist/config/defaults.test.js +33 -0
  5. package/dist/config/defaults.test.js.map +1 -1
  6. package/dist/config/loader.d.ts +2 -0
  7. package/dist/config/loader.d.ts.map +1 -1
  8. package/dist/config/loader.js +10 -5
  9. package/dist/config/loader.js.map +1 -1
  10. package/dist/config/resolve.d.ts +35 -6
  11. package/dist/config/resolve.d.ts.map +1 -1
  12. package/dist/config/resolve.js +98 -18
  13. package/dist/config/resolve.js.map +1 -1
  14. package/dist/config/resolve.test.js +244 -1
  15. package/dist/config/resolve.test.js.map +1 -1
  16. package/dist/config/types.d.ts +711 -78
  17. package/dist/config/types.d.ts.map +1 -1
  18. package/dist/config/types.js +138 -1
  19. package/dist/config/types.js.map +1 -1
  20. package/dist/config/types.test.js +78 -1
  21. package/dist/config/types.test.js.map +1 -1
  22. package/dist/i18n/index.d.ts +1 -1
  23. package/dist/i18n/index.d.ts.map +1 -1
  24. package/dist/i18n/index.js +116 -0
  25. package/dist/i18n/index.js.map +1 -1
  26. package/dist/index.d.ts +3 -2
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +3 -2
  29. package/dist/index.js.map +1 -1
  30. package/dist/schemas/index.d.ts +558 -24
  31. package/dist/schemas/index.d.ts.map +1 -1
  32. package/dist/schemas/index.js +244 -7
  33. package/dist/schemas/index.js.map +1 -1
  34. package/dist/schemas/index.test.d.ts +2 -0
  35. package/dist/schemas/index.test.d.ts.map +1 -0
  36. package/dist/schemas/index.test.js +154 -0
  37. package/dist/schemas/index.test.js.map +1 -0
  38. package/dist/skills/frontmatter.d.ts +21 -0
  39. package/dist/skills/frontmatter.d.ts.map +1 -0
  40. package/dist/skills/frontmatter.js +70 -0
  41. package/dist/skills/frontmatter.js.map +1 -0
  42. package/dist/skills/frontmatter.test.d.ts +2 -0
  43. package/dist/skills/frontmatter.test.d.ts.map +1 -0
  44. package/dist/skills/frontmatter.test.js +65 -0
  45. package/dist/skills/frontmatter.test.js.map +1 -0
  46. package/dist/types/commands.d.ts +128 -0
  47. package/dist/types/commands.d.ts.map +1 -0
  48. package/dist/types/commands.js +11 -0
  49. package/dist/types/commands.js.map +1 -0
  50. package/dist/types/index.d.ts +137 -12
  51. package/dist/types/index.d.ts.map +1 -1
  52. package/dist/types/index.js +68 -5
  53. package/dist/types/index.js.map +1 -1
  54. package/dist/types/permission.d.ts +5 -4
  55. package/dist/types/permission.d.ts.map +1 -1
  56. package/dist/types/skills.d.ts +136 -0
  57. package/dist/types/skills.d.ts.map +1 -0
  58. package/dist/types/skills.js +18 -0
  59. package/dist/types/skills.js.map +1 -0
  60. package/dist/utils/index.d.ts +1 -0
  61. package/dist/utils/index.d.ts.map +1 -1
  62. package/dist/utils/index.js +2 -0
  63. package/dist/utils/index.js.map +1 -1
  64. package/dist/utils/workspace.d.ts +14 -0
  65. package/dist/utils/workspace.d.ts.map +1 -0
  66. package/dist/utils/workspace.js +35 -0
  67. package/dist/utils/workspace.js.map +1 -0
  68. package/dist/utils/workspace.test.d.ts +2 -0
  69. package/dist/utils/workspace.test.d.ts.map +1 -0
  70. package/dist/utils/workspace.test.js +40 -0
  71. package/dist/utils/workspace.test.js.map +1 -0
  72. package/dist/version.d.ts +1 -1
  73. package/dist/version.js +1 -1
  74. package/package.json +1 -1
@@ -0,0 +1,70 @@
1
+ import { load as parseYaml, dump as dumpYaml } from 'js-yaml';
2
+ /**
3
+ * AD-046 §3.1: толерантный парсер YAML-frontmatter `SKILL.md`.
4
+ *
5
+ * - Неизвестные ключи — не ошибка (совместимость Anthropic/opencode/Claude Code).
6
+ * - Невалидный YAML — фиксируется issue, но не бросает исключение.
7
+ * - Файл без frontmatter — `hasFrontmatter: false`, тело — весь документ.
8
+ *
9
+ * Хелпер не выполняет валидацию `name`/`description` (это делает parser ядра):
10
+ * он лишь отделяет frontmatter от тела и нормализует YAML-объект.
11
+ */
12
+ /** Открывающий `---` в самом начале документа (с возможным BOM/переводом строк). */
13
+ const FRONTMATTER_RE = /^\uFEFF?---[ \t]*\r?\n([\s\S]*?)(?:\r?\n)?---[ \t]*(?:\r?\n|$)/;
14
+ /**
15
+ * Разбирает frontmatter. Возвращает issues, а не throw — вызывающая сторона
16
+ * решает, блокирует ли проблема загрузку скилла.
17
+ */
18
+ export function parseFrontmatter(raw) {
19
+ const match = FRONTMATTER_RE.exec(raw);
20
+ if (!match) {
21
+ return { data: {}, body: raw, issues: [], hasFrontmatter: false };
22
+ }
23
+ const yamlBlock = match[1] ?? '';
24
+ const body = raw.slice(match[0].length);
25
+ let parsed;
26
+ try {
27
+ parsed = parseYaml(yamlBlock);
28
+ }
29
+ catch (err) {
30
+ return {
31
+ data: {},
32
+ body,
33
+ hasFrontmatter: true,
34
+ issues: [{
35
+ code: 'invalid-frontmatter',
36
+ message: `невалидный YAML frontmatter: ${err instanceof Error ? err.message : String(err)}`,
37
+ }],
38
+ };
39
+ }
40
+ if (parsed === null || parsed === undefined) {
41
+ return { data: {}, body, hasFrontmatter: true, issues: [] };
42
+ }
43
+ if (typeof parsed !== 'object' || Array.isArray(parsed)) {
44
+ return {
45
+ data: {},
46
+ body,
47
+ hasFrontmatter: true,
48
+ issues: [{
49
+ code: 'invalid-frontmatter-type',
50
+ message: 'frontmatter должен быть YAML-объектом',
51
+ }],
52
+ };
53
+ }
54
+ return {
55
+ data: parsed,
56
+ body,
57
+ hasFrontmatter: true,
58
+ issues: [],
59
+ };
60
+ }
61
+ /**
62
+ * Сериализует frontmatter + тело обратно в `SKILL.md`. Используется записью
63
+ * instance-скиллов через сервис (не ручной записью JSON/файлов).
64
+ */
65
+ export function stringifyFrontmatter(data, body) {
66
+ const yaml = dumpYaml(data, { indent: 2, lineWidth: 120, noRefs: true, sortKeys: false }).trimEnd();
67
+ const normalizedBody = body.replace(/^\n+/, '');
68
+ return `---\n${yaml}\n---\n\n${normalizedBody}`;
69
+ }
70
+ //# sourceMappingURL=frontmatter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG9D;;;;;;;;;GASG;AAEH,oFAAoF;AACpF,MAAM,cAAc,GAAG,gEAAgE,CAAC;AAYxF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,EAAE;YACR,IAAI;YACJ,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,CAAC;oBACP,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;iBAC5F,CAAC;SACH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO;YACL,IAAI,EAAE,EAAE;YACR,IAAI;YACJ,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,CAAC;oBACP,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,uCAAuC;iBACjD,CAAC;SACH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAiC;QACvC,IAAI;QACJ,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA6B,EAAE,IAAY;IAC9E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACpG,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,QAAQ,IAAI,YAAY,cAAc,EAAE,CAAC;AAClD,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=frontmatter.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter.test.d.ts","sourceRoot":"","sources":["../../src/skills/frontmatter.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,65 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { parseFrontmatter, stringifyFrontmatter } from './frontmatter.js';
3
+ describe('parseFrontmatter (AD-046 §3.1)', () => {
4
+ it('разбирает frontmatter и тело', () => {
5
+ const raw = '---\nname: api-review\ndescription: Проверяет API\n---\n\n# Тело\n';
6
+ const parsed = parseFrontmatter(raw);
7
+ expect(parsed.hasFrontmatter).toBe(true);
8
+ expect(parsed.issues).toEqual([]);
9
+ expect(parsed.data).toEqual({ name: 'api-review', description: 'Проверяет API' });
10
+ expect(parsed.body).toBe('\n# Тело\n');
11
+ });
12
+ it('файл без frontmatter — тело целиком, без ошибок', () => {
13
+ const parsed = parseFrontmatter('# Just markdown\n');
14
+ expect(parsed.hasFrontmatter).toBe(false);
15
+ expect(parsed.data).toEqual({});
16
+ expect(parsed.body).toBe('# Just markdown\n');
17
+ expect(parsed.issues).toEqual([]);
18
+ });
19
+ it('неизвестные ключи не являются ошибкой (совместимость)', () => {
20
+ const raw = '---\nname: x\ndescription: y\nfuture_key: 42\nnested: {a: 1}\n---\nbody';
21
+ const parsed = parseFrontmatter(raw);
22
+ expect(parsed.issues).toEqual([]);
23
+ expect(parsed.data.future_key).toBe(42);
24
+ expect(parsed.data.nested).toEqual({ a: 1 });
25
+ });
26
+ it('невалидный YAML — issue, не throw', () => {
27
+ const raw = '---\nname: [unclosed\n---\nbody';
28
+ const parsed = parseFrontmatter(raw);
29
+ expect(parsed.hasFrontmatter).toBe(true);
30
+ expect(parsed.issues.map((i) => i.code)).toContain('invalid-frontmatter');
31
+ expect(parsed.data).toEqual({});
32
+ expect(parsed.body).toBe('body');
33
+ });
34
+ it('frontmatter-не-объект — issue invalid-frontmatter-type', () => {
35
+ const raw = '---\n- a\n- b\n---\nbody';
36
+ const parsed = parseFrontmatter(raw);
37
+ expect(parsed.issues.map((i) => i.code)).toEqual(['invalid-frontmatter-type']);
38
+ expect(parsed.body).toBe('body');
39
+ });
40
+ it('пустой frontmatter — пустой объект без ошибок', () => {
41
+ const raw = '---\n---\nbody';
42
+ const parsed = parseFrontmatter(raw);
43
+ expect(parsed.hasFrontmatter).toBe(true);
44
+ expect(parsed.data).toEqual({});
45
+ expect(parsed.body).toBe('body');
46
+ });
47
+ it('поддерживает BOM и CRLF', () => {
48
+ const raw = '\uFEFF---\r\nname: x\r\ndescription: y\r\n---\r\nbody';
49
+ const parsed = parseFrontmatter(raw);
50
+ expect(parsed.hasFrontmatter).toBe(true);
51
+ expect(parsed.data.name).toBe('x');
52
+ expect(parsed.body).toBe('body');
53
+ });
54
+ });
55
+ describe('stringifyFrontmatter', () => {
56
+ it('сериализует данные и тело, round-trip сохраняет значения', () => {
57
+ const out = stringifyFrontmatter({ name: 'x', description: 'y' }, '# Тело');
58
+ expect(out.startsWith('---\n')).toBe(true);
59
+ expect(out).toContain('---\n\n# Тело');
60
+ const parsed = parseFrontmatter(out);
61
+ expect(parsed.data).toEqual({ name: 'x', description: 'y' });
62
+ expect(parsed.body).toBe('\n# Тело');
63
+ });
64
+ });
65
+ //# sourceMappingURL=frontmatter.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter.test.js","sourceRoot":"","sources":["../../src/skills/frontmatter.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,128 @@
1
+ import type { SkillScope, SkillLevel } from './skills.js';
2
+ import type { PermissionConfig } from './permission.js';
3
+ /**
4
+ * AD-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
5
+ * бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
6
+ */
7
+ /** Вид команды (AD-046 §7.2). */
8
+ export declare const COMMAND_KINDS: readonly ["builtin", "template", "skill", "bundle"];
9
+ export type CommandKind = (typeof COMMAND_KINDS)[number];
10
+ /** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
11
+ export declare const COMMAND_CONFLICT_MODES: readonly ["bundle-wins", "conservative", "namespace"];
12
+ export type CommandConflictMode = (typeof COMMAND_CONFLICT_MODES)[number];
13
+ /** Кто инициировал команду (для события `command.invoked`, §8.2). */
14
+ export declare const COMMAND_ACTORS: readonly ["user", "cli"];
15
+ export type CommandActor = (typeof COMMAND_ACTORS)[number];
16
+ /** Уровень диагностики discovery/валидации команд. */
17
+ export type CommandDiagnosticLevel = 'error' | 'warning' | 'info';
18
+ /** Коды диагностики команд/бандлов (только реально эмитируемые). */
19
+ export type CommandIssueCode = 'invalid-frontmatter' | 'missing-name' | 'shadowed' | 'collision' | 'invalid-bundle' | 'missing-skill' | 'read-error'
20
+ /** AD-046 §4.4/§7.1: проектный каталог недоверенный — команда не грузится. */
21
+ | 'untrusted';
22
+ /** Диагностика реестра команд (видна в `GET /api/v2/commands?diagnostics=1`). */
23
+ export interface CommandDiagnostic {
24
+ level: CommandDiagnosticLevel;
25
+ code: CommandIssueCode;
26
+ message: string;
27
+ /** Имя команды/бандла (если известно). */
28
+ command?: string;
29
+ /** Путь к файлу/каталогу (если применимо). */
30
+ path?: string;
31
+ }
32
+ /**
33
+ * YAML-группа скиллов (AD-046 §7.3). `/bundle-name` грузит N тел одним
34
+ * сообщением; bundle побеждает одноимённый skill.
35
+ */
36
+ export interface SkillBundle {
37
+ name: string;
38
+ description: string;
39
+ skills: string[];
40
+ /** Дополнительная инструкция над телами скиллов (опционально). */
41
+ instruction?: string;
42
+ }
43
+ /** Сводка команды (для `GET /api/v2/commands` и автокомплита). */
44
+ export interface CommandSummary {
45
+ name: string;
46
+ kind: CommandKind;
47
+ description: string;
48
+ argumentHint?: string;
49
+ scope?: SkillScope;
50
+ level?: SkillLevel;
51
+ /** Имя бандла-источника (для `kind: 'bundle'`). */
52
+ bundle?: string;
53
+ /** Скиллы, входящие в bundle. */
54
+ skills?: string[];
55
+ /** `false` — команда видна, но недоступна (capabilities/deny). */
56
+ available: boolean;
57
+ unavailableReason?: 'capabilities' | 'denied';
58
+ }
59
+ /** Статус результата резолвинга команды. */
60
+ export type CommandResolveStatus = 'builtin' | 'prompt' | 'template' | 'skill' | 'bundle' | 'summarization' | 'unknown' | 'denied' | 'unavailable';
61
+ /**
62
+ * Результат резолвинга `/`-команды (AD-046 §7.1).
63
+ *
64
+ * - `builtin` — локальный ответ (`output`), LLM не вызывается; user+assistant
65
+ * сообщения помечаются `ephemeral` и исключаются из LLM-контекста;
66
+ * - `prompt` — встроенная команда, генерирующая prompt (`/init`): текст в
67
+ * `prompt` уходит в LLM как явный пользовательский контекст, локального
68
+ * ответа нет и CLI не короткозамыкает;
69
+ * - `template`/`skill`/`bundle` — текст в `prompt` уходит в LLM как явный
70
+ * пользовательский контекст;
71
+ * - `summarization` — триггер ручной суммаризации (`/summary`);
72
+ * - `unknown`/`denied`/`unavailable` — ответ-объяснение, LLM не вызывается.
73
+ */
74
+ export interface CommandResolveResult {
75
+ status: CommandResolveStatus;
76
+ /** Имя команды без `/`. */
77
+ name: string;
78
+ /** Аргументы после имени. */
79
+ args: string;
80
+ kind?: CommandKind;
81
+ /** Текст, инжектируемый в LLM (template/skill/bundle). */
82
+ prompt?: string;
83
+ /** Локальный ответ (builtin/unknown/denied/unavailable). */
84
+ output?: string;
85
+ /** Загруженные тела скиллов (для событий `skill.invoked`). */
86
+ skills?: string[];
87
+ /** Причина denied/unavailable. */
88
+ message?: string;
89
+ }
90
+ /** AD-046 §7.4: результат исполнения inline shell (`` !`cmd` ``). */
91
+ export interface CommandShellResult {
92
+ output: string;
93
+ isError: boolean;
94
+ }
95
+ /**
96
+ * AD-046 §7.4: раннер inline shell. Оркестратор передаёт замыкание, которое
97
+ * само проходит `PermissionEvaluator` (AD-029) и исполняет команду; сервис
98
+ * команд только вызывает его для подстановки `` !`cmd` ``.
99
+ */
100
+ export type CommandShellRunner = (command: string) => Promise<CommandShellResult>;
101
+ /** Общие опции фильтрации/резолвинга команд. */
102
+ export interface CommandRuntimeOpts {
103
+ projectWorkspace?: string;
104
+ capabilities?: readonly string[];
105
+ agent?: {
106
+ id?: string;
107
+ groups?: string[];
108
+ };
109
+ sessionEnabled?: string[];
110
+ sessionDisabled?: string[];
111
+ permissionConfig?: PermissionConfig;
112
+ /** AD-046 §7.4: раннер inline shell (только при включённом `skills.inlineShell`). */
113
+ runShell?: CommandShellRunner;
114
+ }
115
+ /**
116
+ * AD-046 §7.3: рантайм-контракт команд для оркестратора/CLI. Структурно
117
+ * реализуется `CommandService`; прокидывается в `OrchestratorOptions`.
118
+ */
119
+ export interface CommandRuntime {
120
+ /** Список команд (builtin + template + skills + bundles) с учётом фильтров. */
121
+ list(opts?: CommandRuntimeOpts): Promise<{
122
+ commands: CommandSummary[];
123
+ diagnostics: CommandDiagnostic[];
124
+ }>;
125
+ /** Резолвинг `/`-команды. `undefined` — сообщение не является командой. */
126
+ resolve(input: string, opts?: CommandRuntimeOpts): Promise<CommandResolveResult | undefined>;
127
+ }
128
+ //# sourceMappingURL=commands.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * AD-046 §7: slash-команды и bundles — контракты. Здесь только типы (без
3
+ * бизнес-логики движка); резолвинг выполняется в core до обращения к LLM.
4
+ */
5
+ /** Вид команды (AD-046 §7.2). */
6
+ export const COMMAND_KINDS = ['builtin', 'template', 'skill', 'bundle'];
7
+ /** Режим разрешения конфликтов имён (настройка `commands.conflict.mode`). */
8
+ export const COMMAND_CONFLICT_MODES = ['bundle-wins', 'conservative', 'namespace'];
9
+ /** Кто инициировал команду (для события `command.invoked`, §8.2). */
10
+ export const COMMAND_ACTORS = ['user', 'cli'];
11
+ //# sourceMappingURL=commands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGjF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAG5F,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC"}
@@ -153,9 +153,10 @@ export interface PromptToolDetail {
153
153
  available: boolean;
154
154
  /**
155
155
  * Причина недоступности: `mode` (переключить режим), `role` (делегировать),
156
- * `admin_disabled` (жёстко отключён администратором через `tools.disabled`).
156
+ * `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
157
+ * `dependency` (в окружении нет нужной программы — git/rg/sh).
157
158
  */
158
- reason?: 'mode' | 'role' | 'admin_disabled';
159
+ reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency';
159
160
  /** AD-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
160
161
  source: 'built-in';
161
162
  /** AD-071 §2.6: длина `JSON.stringify` LLM-определения тула (как слой `tools`). */
@@ -292,6 +293,11 @@ export interface Message {
292
293
  disabled: boolean;
293
294
  pinned: boolean;
294
295
  hidden: boolean;
296
+ /**
297
+ * AD-046 §7.1: сообщение локальной `/`-команды (builtin-ответ) — видно в
298
+ * истории, но исключается из LLM-контекста.
299
+ */
300
+ ephemeral?: boolean;
295
301
  debugData?: Record<string, unknown>;
296
302
  model?: string;
297
303
  provider?: string;
@@ -353,6 +359,16 @@ export interface McpRegistryEntry {
353
359
  origin: McpRegistryOrigin;
354
360
  author: McpRegistryAuthor | null;
355
361
  trust: McpRegistryTrust;
362
+ /**
363
+ * Системный мастер-флаг (hard-gate): `false` — сервер недоступен НИГДЕ и НИКОГДА
364
+ * (в т.ч. в старых сессиях). Дефолт `true`.
365
+ */
366
+ enabled: boolean;
367
+ /**
368
+ * Переосмыслено: «включён по умолчанию для НОВЫХ ПРОЕКТОВ» — сид
369
+ * `project.mcp.enabled`/`project.mcp.defaultOn` при создании проекта. Снимок:
370
+ * изменение не влияет на ранее созданные проекты/сессии.
371
+ */
356
372
  enabledByDefault: boolean;
357
373
  createdAt: string;
358
374
  updatedAt: string;
@@ -376,12 +392,15 @@ export declare const MCP_SERVER_LEVELS: readonly ["system", "project", "session"
376
392
  export type McpServerLevel = (typeof MCP_SERVER_LEVELS)[number];
377
393
  /**
378
394
  * AD-071 §2.2: почему сервер отключён в эффективном наборе сессии:
379
- * - `config` — выключен в конфиге записи (`config.enabled === false`);
395
+ * - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
396
+ * - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
380
397
  * - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
381
- * - `project_disabled` — проектный сервер не включён в проекте (`project.defaultOn`);
382
- * - `not_default` — нет `enabledByDefault` и не включён явно.
398
+ * - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
399
+ *
400
+ * Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
401
+ * реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
383
402
  */
384
- export declare const MCP_DISABLED_REASONS: readonly ["session_optout", "project_disabled", "not_default", "config"];
403
+ export declare const MCP_DISABLED_REASONS: readonly ["system_disabled", "project_disabled", "session_optout", "not_default"];
385
404
  export type McpDisabledReason = (typeof MCP_DISABLED_REASONS)[number];
386
405
  /**
387
406
  * AD-071 §2.4: эффективное состояние MCP-сервера для сессии. Отдаётся API
@@ -443,9 +462,15 @@ export interface SessionSettings {
443
462
  mcpServers?: string[];
444
463
  /**
445
464
  * AD-071 §2.4: явные opt-out серверы сессии (включая системные). Вычитаются
446
- * из эффективного набора (`(instance.defaultOn ∪ project.defaultOn ∪ enabled) − disabled`).
465
+ * из эффективного набора (`(seed ∪ enabled) − disabled`).
447
466
  */
448
467
  mcpDisabledServers?: string[];
468
+ /**
469
+ * AD-071 §2.4: СНАПШОТ MCP-серверов «по умолчанию» на момент создания сессии
470
+ * (снимок `project.defaultOn` либо системного дефолта `enabledByDefault`).
471
+ * Изменение дефолта проекта/системы не влияет на существующие сессии.
472
+ */
473
+ mcpDefaultOn?: string[];
449
474
  contextOptimization: 'none' | 'sliding_window' | 'summarization' | 'sticky_notes';
450
475
  slidingWindowMode: 'messages' | 'tokens';
451
476
  slidingWindowMessageLimit: number;
@@ -523,6 +548,16 @@ export interface SessionSettings {
523
548
  mcpPolicy?: ToolsPolicy;
524
549
  /** Строгость цикла Plan→Build: auto — модель сама решает, strict — план обязателен, off — планирование отключено. */
525
550
  planMode?: PlanMode;
551
+ /** AD-046: явно включённые в сессии имена скиллов (session level, volatile-каталог). */
552
+ skills?: string[];
553
+ /** AD-046: opt-out сессии — имена, категории или группы скиллов (volatile-каталог). */
554
+ skillsDisabled?: string[];
555
+ /**
556
+ * AD-046: СНАПШОТ скиллов «по умолчанию» на момент создания сессии (снимок
557
+ * `project.skills.defaultOn` либо системного дефолта). Изменение дефолта
558
+ * проекта/системы не влияет на существующие сессии.
559
+ */
560
+ skillsDefaultOn?: string[];
526
561
  /** Per-session override LLM Gateway (AD-036). */
527
562
  llmGateway?: {
528
563
  enabled?: boolean;
@@ -566,6 +601,10 @@ export interface SessionReference {
566
601
  export interface Session {
567
602
  id: string;
568
603
  title?: string;
604
+ /** Канонический ключ иконки (PROJECT_ICON_KEYS); legacy-значения → undefined. */
605
+ icon?: string;
606
+ /** Канонический ключ цвета (PROJECT_COLOR_KEYS); legacy-значения нормализуются. */
607
+ color?: string;
569
608
  sessionOrigin: SessionOrigin;
570
609
  parentId?: string;
571
610
  branchPoint?: string;
@@ -615,10 +654,41 @@ export interface Session {
615
654
  */
616
655
  cacheHitRate?: number;
617
656
  }
657
+ /**
658
+ * AD-076: запись реестра git-репозиториев проекта. Старые данные (`repos` как
659
+ * `string[]` либо `{ path }`) нормализуются через `normalizeGitRepoConfig`.
660
+ */
618
661
  export interface GitRepoConfig {
662
+ /** Стабильный id записи реестра (uuid); отсутствует у обнаруженных scan-ом. */
663
+ id?: string;
664
+ name?: string;
665
+ url?: string;
666
+ type?: 'https' | 'ssh';
667
+ /** Относительный путь ВНУТРИ project.workspace (допускает вложенность). */
619
668
  path: string;
620
669
  defaultBranch?: string;
670
+ sshKeyId?: string;
671
+ lastFetch?: string;
672
+ }
673
+ /**
674
+ * AD-076: SSH-ключ агента — отдельная сущность реестра (не в
675
+ * `AgentDefinition`). Секреты `privateKey`/`passphrase` шифруются at-rest
676
+ * (AES-256-GCM; реализация — в core) и НИКОГДА не отдаются через API.
677
+ */
678
+ export interface SSHKey {
679
+ id: string;
680
+ name: string;
681
+ /** Метка типа ключа, дефолт `'user'`. */
682
+ type?: string;
683
+ privateKey: string;
684
+ passphrase?: string;
685
+ /** Привязка к агентам: один ключ может обслуживать несколько агентов. */
686
+ agentIds: string[];
687
+ createdAt: string;
688
+ updatedAt?: string;
621
689
  }
690
+ /** Публичное представление ключа (без `privateKey`/`passphrase`). */
691
+ export type SSHKeyMeta = Omit<SSHKey, 'privateKey' | 'passphrase'>;
622
692
  export interface RepoStatus {
623
693
  path: string;
624
694
  isRepo: boolean;
@@ -662,13 +732,48 @@ export interface ProjectLogEntry {
662
732
  }
663
733
  /**
664
734
  * AD-071 §2.4/§2.5: проектный скоуп MCP — ссылки на записи единого реестра по
665
- * имени. `enabled` — доступные проекту серверы (гейт owner/lead),
666
- * `defaultOn` — включённые по умолчанию для всех сессий проекта.
735
+ * имени.
736
+ * - `enabled` — hard-gate: серверы, разрешённые проекту. Не разрешённый сервер
737
+ * недоступен ни в одной сессии проекта (в т.ч. старой). Пустой массив — «всё
738
+ * выключено» (opt-in); отсутствие `project.mcp` — гейт не задан (legacy).
739
+ * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот `mcpDefaultOn`
740
+ * при создании сессии. Изменение не влияет на ранее созданные сессии.
667
741
  */
668
742
  export interface ProjectMcpSettings {
669
743
  enabled: string[];
670
744
  defaultOn: string[];
671
745
  }
746
+ /**
747
+ * AD-046 §4.5: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
748
+ * - `enabled` — hard-gate: доступные проекту скиллы. Пустой массив — «всё
749
+ * выключено» (opt-in); отсутствие `project.skills` — гейт не задан (legacy).
750
+ * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот
751
+ * `skillsDefaultOn` при создании сессии.
752
+ */
753
+ export interface ProjectSkillSettings {
754
+ enabled: string[];
755
+ defaultOn: string[];
756
+ }
757
+ /**
758
+ * AD-075: политика для абсолютного `project.workspace` вне `workspacesRoot`.
759
+ * - `confirm` — путь разрешён только с явным подтверждением (`confirmOutsideRoot`);
760
+ * - `deny` — путь запрещён (managed-развёртывание: жёстко).
761
+ *
762
+ * Значение `''` (пустая строка) в конфиге означает «не задано» — эффективной
763
+ * политикой тогда считается `confirm` (резолвер `resolveWorkspaceOutsideRootPolicy`).
764
+ */
765
+ export type WorkspaceOutsideRootPolicy = 'confirm' | 'deny';
766
+ /**
767
+ * AD-075: ответ `GET /api/v2/settings/workspace-policy`.
768
+ * `readOnly` (additive) — managed-развёртывание: политика задаётся развёртыванием,
769
+ * `PUT`/`DELETE` возвращают 403 `WORKSPACE_POLICY_READ_ONLY`.
770
+ */
771
+ export interface WorkspacePolicyInfo {
772
+ outsideRoot: WorkspaceOutsideRootPolicy;
773
+ isOverridden: boolean;
774
+ defaults: WorkspaceOutsideRootPolicy;
775
+ readOnly?: boolean;
776
+ }
672
777
  export interface Project {
673
778
  id: string;
674
779
  name: string;
@@ -683,6 +788,8 @@ export interface Project {
683
788
  repos?: GitRepoConfig[];
684
789
  /** AD-071 §2.4: проектный скоуп MCP (owner/lead). */
685
790
  mcp?: ProjectMcpSettings;
791
+ /** AD-046 §4.5: проектный скоуп скиллов (owner/lead). */
792
+ skills?: ProjectSkillSettings;
686
793
  statusMessages: StatusMessage[];
687
794
  /** Kanban-план проекта (AD-039). Владеет проектом, а не сессией. */
688
795
  plan?: ProjectPlan;
@@ -691,6 +798,15 @@ export interface Project {
691
798
  createdAt: string;
692
799
  updatedAt: string;
693
800
  }
801
+ /**
802
+ * Канонические ключи иконок проектов и сессий (единый список для server и UI).
803
+ * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
804
+ */
805
+ 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"];
806
+ export type ProjectIconKey = (typeof PROJECT_ICON_KEYS)[number];
807
+ /** Канонические ключи цветов проектов и сессий (единый список для server и UI). */
808
+ export declare const PROJECT_COLOR_KEYS: readonly ["keyword", "string", "number", "type", "comment", "error", "primary", "success"];
809
+ export type ProjectColorKey = (typeof PROJECT_COLOR_KEYS)[number];
694
810
  export interface PlanColumn {
695
811
  id: string;
696
812
  name: string;
@@ -771,11 +887,16 @@ export interface AgentDefinition {
771
887
  agentMode?: AgentMode | AgentMode[];
772
888
  subagentPrompt?: string;
773
889
  maxSteps?: number;
774
- sshKeys: string[];
775
890
  isOverridden: boolean;
776
891
  icon?: string;
777
892
  color?: string;
778
893
  description?: string;
894
+ /**
895
+ * AD-046 §6.2: группы агентов для привязки скиллов
896
+ * (`metadata.synth.groups`). Пусто/не задано — скилл с непустым `groups`
897
+ * не привязан к агенту.
898
+ */
899
+ groups?: string[];
779
900
  }
780
901
  /** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
781
902
  export declare const CURRENCIES: readonly ["RUB", "USD", "CNY"];
@@ -919,7 +1040,7 @@ export interface QueueItem {
919
1040
  streamId: string;
920
1041
  enqueuedAt: string;
921
1042
  }
922
- 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' | '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' | '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' | 'error';
1043
+ 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' | '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' | 'error';
923
1044
  export interface BusEvent {
924
1045
  type: EventType;
925
1046
  sessionId: string;
@@ -936,7 +1057,9 @@ export declare enum FsErrorCode {
936
1057
  WORKSPACE_NOT_FOUND = "WORKSPACE_NOT_FOUND",
937
1058
  PERMISSION_DENIED = "PERMISSION_DENIED",
938
1059
  ALREADY_EXISTS = "ALREADY_EXISTS",
939
- DIR_NOT_EMPTY = "DIR_NOT_EMPTY"
1060
+ DIR_NOT_EMPTY = "DIR_NOT_EMPTY",
1061
+ /** AD-075: путь вне `workspacesRoot` запрещён политикой (managed). */
1062
+ WORKSPACE_OUTSIDE_ROOT_DENIED = "WORKSPACE_OUTSIDE_ROOT_DENIED"
940
1063
  }
941
1064
  export interface FileEntry {
942
1065
  name: string;
@@ -970,4 +1093,6 @@ export interface FsError {
970
1093
  }
971
1094
  export * from './tools.js';
972
1095
  export * from './permission.js';
1096
+ export * from './skills.js';
1097
+ export * from './commands.js';
973
1098
  //# sourceMappingURL=index.d.ts.map