@itphx/synth-shared 0.7.3 → 0.8.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.d.ts +0 -1
- package/dist/config/defaults.js +44 -1
- package/dist/config/index.d.ts +0 -1
- package/dist/config/index.js +0 -1
- package/dist/config/loader.d.ts +2 -1
- package/dist/config/loader.js +10 -6
- package/dist/config/merge.d.ts +0 -1
- package/dist/config/merge.js +0 -1
- package/dist/config/resolve.d.ts +35 -7
- package/dist/config/resolve.js +98 -19
- package/dist/config/types.d.ts +711 -79
- package/dist/config/types.js +138 -2
- package/dist/i18n/index.d.ts +1 -2
- package/dist/i18n/index.js +116 -1
- package/dist/index.d.ts +3 -3
- package/dist/index.js +3 -3
- package/dist/interfaces/index.d.ts +0 -1
- package/dist/interfaces/index.js +0 -1
- package/dist/model-metadata.d.ts +0 -1
- package/dist/model-metadata.js +0 -1
- package/dist/protocols/index.d.ts +0 -1
- package/dist/protocols/index.js +0 -1
- package/dist/schemas/index.d.ts +558 -25
- package/dist/schemas/index.js +244 -8
- package/dist/skills/frontmatter.d.ts +20 -0
- package/dist/skills/frontmatter.js +69 -0
- package/dist/types/commands.d.ts +127 -0
- package/dist/types/commands.js +10 -0
- package/dist/types/index.d.ts +137 -13
- package/dist/types/index.js +68 -6
- package/dist/types/permission.d.ts +5 -5
- package/dist/types/permission.js +0 -1
- package/dist/types/skills.d.ts +135 -0
- package/dist/types/skills.js +17 -0
- package/dist/types/tools.d.ts +0 -1
- package/dist/types/tools.js +0 -1
- package/dist/utils/glob.d.ts +0 -1
- package/dist/utils/glob.js +0 -1
- package/dist/utils/index.d.ts +1 -1
- package/dist/utils/index.js +2 -1
- package/dist/utils/workspace.d.ts +13 -0
- package/dist/utils/workspace.js +34 -0
- package/dist/version.d.ts +1 -2
- package/dist/version.js +1 -2
- package/package.json +2 -2
- package/dist/config/defaults.d.ts.map +0 -1
- package/dist/config/defaults.js.map +0 -1
- package/dist/config/defaults.test.d.ts +0 -2
- package/dist/config/defaults.test.d.ts.map +0 -1
- package/dist/config/defaults.test.js +0 -66
- package/dist/config/defaults.test.js.map +0 -1
- package/dist/config/index.d.ts.map +0 -1
- package/dist/config/index.js.map +0 -1
- package/dist/config/loader.d.ts.map +0 -1
- package/dist/config/loader.js.map +0 -1
- package/dist/config/loader.test.d.ts +0 -2
- package/dist/config/loader.test.d.ts.map +0 -1
- package/dist/config/loader.test.js +0 -43
- package/dist/config/loader.test.js.map +0 -1
- package/dist/config/merge.d.ts.map +0 -1
- package/dist/config/merge.js.map +0 -1
- package/dist/config/merge.test.d.ts +0 -2
- package/dist/config/merge.test.d.ts.map +0 -1
- package/dist/config/merge.test.js +0 -49
- package/dist/config/merge.test.js.map +0 -1
- package/dist/config/resolve.d.ts.map +0 -1
- package/dist/config/resolve.js.map +0 -1
- package/dist/config/resolve.test.d.ts +0 -2
- package/dist/config/resolve.test.d.ts.map +0 -1
- package/dist/config/resolve.test.js +0 -81
- package/dist/config/resolve.test.js.map +0 -1
- package/dist/config/types.d.ts.map +0 -1
- package/dist/config/types.js.map +0 -1
- package/dist/config/types.test.d.ts +0 -2
- package/dist/config/types.test.d.ts.map +0 -1
- package/dist/config/types.test.js +0 -63
- package/dist/config/types.test.js.map +0 -1
- package/dist/i18n/index.d.ts.map +0 -1
- package/dist/i18n/index.js.map +0 -1
- package/dist/i18n/index.test.d.ts +0 -2
- package/dist/i18n/index.test.d.ts.map +0 -1
- package/dist/i18n/index.test.js +0 -41
- package/dist/i18n/index.test.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/interfaces/index.d.ts.map +0 -1
- package/dist/interfaces/index.js.map +0 -1
- package/dist/model-metadata.d.ts.map +0 -1
- package/dist/model-metadata.js.map +0 -1
- package/dist/model-metadata.test.d.ts +0 -2
- package/dist/model-metadata.test.d.ts.map +0 -1
- package/dist/model-metadata.test.js +0 -53
- package/dist/model-metadata.test.js.map +0 -1
- package/dist/protocols/index.d.ts.map +0 -1
- package/dist/protocols/index.js.map +0 -1
- package/dist/schemas/index.d.ts.map +0 -1
- package/dist/schemas/index.js.map +0 -1
- package/dist/types/index.d.ts.map +0 -1
- package/dist/types/index.js.map +0 -1
- package/dist/types/permission.d.ts.map +0 -1
- package/dist/types/permission.js.map +0 -1
- package/dist/types/tools.d.ts.map +0 -1
- package/dist/types/tools.js.map +0 -1
- package/dist/utils/glob.d.ts.map +0 -1
- package/dist/utils/glob.js.map +0 -1
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/index.js.map +0 -1
- package/dist/utils/index.test.d.ts +0 -2
- package/dist/utils/index.test.d.ts.map +0 -1
- package/dist/utils/index.test.js +0 -150
- package/dist/utils/index.test.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
package/dist/types/index.d.ts
CHANGED
|
@@ -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
|
-
* - `
|
|
395
|
+
* - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
|
|
396
|
+
* - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
|
|
380
397
|
* - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
|
|
381
|
-
* - `
|
|
382
|
-
*
|
|
398
|
+
* - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
|
|
399
|
+
*
|
|
400
|
+
* Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
|
|
401
|
+
* реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
|
|
383
402
|
*/
|
|
384
|
-
export declare const MCP_DISABLED_REASONS: readonly ["
|
|
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
|
-
* из эффективного набора (`(
|
|
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
|
-
* имени.
|
|
666
|
-
* `
|
|
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,5 @@ export interface FsError {
|
|
|
970
1093
|
}
|
|
971
1094
|
export * from './tools.js';
|
|
972
1095
|
export * from './permission.js';
|
|
973
|
-
|
|
1096
|
+
export * from './skills.js';
|
|
1097
|
+
export * from './commands.js';
|
package/dist/types/index.js
CHANGED
|
@@ -82,19 +82,76 @@ export const DEFAULT_MCP_NETWORK_POLICY = {
|
|
|
82
82
|
export const MCP_SERVER_LEVELS = ['system', 'project', 'session'];
|
|
83
83
|
/**
|
|
84
84
|
* AD-071 §2.2: почему сервер отключён в эффективном наборе сессии:
|
|
85
|
-
* - `
|
|
85
|
+
* - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
|
|
86
|
+
* - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
|
|
86
87
|
* - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
|
|
87
|
-
* - `
|
|
88
|
-
*
|
|
88
|
+
* - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
|
|
89
|
+
*
|
|
90
|
+
* Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
|
|
91
|
+
* реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
|
|
89
92
|
*/
|
|
90
93
|
export const MCP_DISABLED_REASONS = [
|
|
91
|
-
'
|
|
94
|
+
'system_disabled',
|
|
92
95
|
'project_disabled',
|
|
96
|
+
'session_optout',
|
|
93
97
|
'not_default',
|
|
94
|
-
'config',
|
|
95
98
|
];
|
|
96
99
|
export const TODO_STATUSES = ['pending', 'in_progress', 'completed', 'cancelled'];
|
|
97
100
|
export const TODO_PRIORITIES = ['high', 'medium', 'low'];
|
|
101
|
+
/**
|
|
102
|
+
* Канонические ключи иконок проектов и сессий (единый список для server и UI).
|
|
103
|
+
* Значения — только ключи реестра (загружаемые картинки не поддерживаются).
|
|
104
|
+
*/
|
|
105
|
+
export const PROJECT_ICON_KEYS = [
|
|
106
|
+
'code',
|
|
107
|
+
'terminal',
|
|
108
|
+
'rocket',
|
|
109
|
+
'flask',
|
|
110
|
+
'gamepad',
|
|
111
|
+
'briefcase',
|
|
112
|
+
'home',
|
|
113
|
+
'globe',
|
|
114
|
+
'leaf',
|
|
115
|
+
'shield',
|
|
116
|
+
'palette',
|
|
117
|
+
'server',
|
|
118
|
+
'phone',
|
|
119
|
+
'database',
|
|
120
|
+
'lightbulb',
|
|
121
|
+
'music',
|
|
122
|
+
'camera',
|
|
123
|
+
'book',
|
|
124
|
+
'heart',
|
|
125
|
+
'folder',
|
|
126
|
+
'chat',
|
|
127
|
+
'cpu',
|
|
128
|
+
'file',
|
|
129
|
+
'file-code',
|
|
130
|
+
'docs',
|
|
131
|
+
'task',
|
|
132
|
+
'todo',
|
|
133
|
+
'bug',
|
|
134
|
+
'robot',
|
|
135
|
+
'brain',
|
|
136
|
+
'git',
|
|
137
|
+
'repo',
|
|
138
|
+
'test',
|
|
139
|
+
'chart',
|
|
140
|
+
'star',
|
|
141
|
+
'image',
|
|
142
|
+
'calendar',
|
|
143
|
+
];
|
|
144
|
+
/** Канонические ключи цветов проектов и сессий (единый список для server и UI). */
|
|
145
|
+
export const PROJECT_COLOR_KEYS = [
|
|
146
|
+
'keyword',
|
|
147
|
+
'string',
|
|
148
|
+
'number',
|
|
149
|
+
'type',
|
|
150
|
+
'comment',
|
|
151
|
+
'error',
|
|
152
|
+
'primary',
|
|
153
|
+
'success',
|
|
154
|
+
];
|
|
98
155
|
// --- Currency ---
|
|
99
156
|
/** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
|
|
100
157
|
export const CURRENCIES = ['RUB', 'USD', 'CNY'];
|
|
@@ -151,9 +208,14 @@ export var FsErrorCode;
|
|
|
151
208
|
FsErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
|
|
152
209
|
FsErrorCode["ALREADY_EXISTS"] = "ALREADY_EXISTS";
|
|
153
210
|
FsErrorCode["DIR_NOT_EMPTY"] = "DIR_NOT_EMPTY";
|
|
211
|
+
/** AD-075: путь вне `workspacesRoot` запрещён политикой (managed). */
|
|
212
|
+
FsErrorCode["WORKSPACE_OUTSIDE_ROOT_DENIED"] = "WORKSPACE_OUTSIDE_ROOT_DENIED";
|
|
154
213
|
})(FsErrorCode || (FsErrorCode = {}));
|
|
155
214
|
// Tool types — re-exported from tools.ts
|
|
156
215
|
export * from './tools.js';
|
|
157
216
|
// Permission types (AD-029) — re-exported from permission.ts
|
|
158
217
|
export * from './permission.js';
|
|
159
|
-
|
|
218
|
+
// Skill types (AD-046) — re-exported from skills.ts
|
|
219
|
+
export * from './skills.js';
|
|
220
|
+
// Slash-команды и bundles (AD-046 §7) — re-exported from commands.ts
|
|
221
|
+
export * from './commands.js';
|
|
@@ -38,12 +38,13 @@ export interface PermissionDecision {
|
|
|
38
38
|
params?: Record<string, string>;
|
|
39
39
|
/**
|
|
40
40
|
* AD-070 §2.9.1: тул недоступен не по жёсткому запрету, а из-за текущего
|
|
41
|
-
* режима (`mode`)
|
|
42
|
-
*
|
|
43
|
-
*
|
|
41
|
+
* режима (`mode`), роли агента (`role`) или отсутствия внешней программы
|
|
42
|
+
* окружения (`dependency`). Отличие от `deny`-политики: доступ открывается
|
|
43
|
+
* переключением режима / делегированием / установкой программы, поэтому модель
|
|
44
|
+
* получает соответствующую подсказку (messageId).
|
|
44
45
|
*/
|
|
45
46
|
unavailable?: {
|
|
46
|
-
reason: 'mode' | 'role';
|
|
47
|
+
reason: 'mode' | 'role' | 'dependency';
|
|
47
48
|
};
|
|
48
49
|
}
|
|
49
50
|
/**
|
|
@@ -62,4 +63,3 @@ export interface McpServerToolSettings {
|
|
|
62
63
|
/** Точечная настройка по имени инструмента (без префикса сервера). */
|
|
63
64
|
tools?: Record<string, McpToolAvailability>;
|
|
64
65
|
}
|
|
65
|
-
//# sourceMappingURL=permission.d.ts.map
|
package/dist/types/permission.js
CHANGED
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import type { ToolCapability } from './tools.js';
|
|
2
|
+
/**
|
|
3
|
+
* AD-046 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
|
|
4
|
+
* Здесь только контракты (типы), без бизнес-логики движка.
|
|
5
|
+
*/
|
|
6
|
+
/** Фактический источник скилла (AD-046 §4.1). */
|
|
7
|
+
export declare const SKILL_SCOPES: readonly ["instance", "project"];
|
|
8
|
+
export type SkillScope = (typeof SKILL_SCOPES)[number];
|
|
9
|
+
/** Уровень включения скилла (модель AD-071 §2.4/AD-046 §4.5). */
|
|
10
|
+
export declare const SKILL_LEVELS: readonly ["system", "project", "session"];
|
|
11
|
+
export type SkillLevel = (typeof SKILL_LEVELS)[number];
|
|
12
|
+
/**
|
|
13
|
+
* AD-046 §6.1: способ вызова скилла — комбинация `user-invocable` /
|
|
14
|
+
* `disable-model-invocation`.
|
|
15
|
+
*/
|
|
16
|
+
export declare const SKILL_INVOCATIONS: readonly ["both", "user", "model", "none"];
|
|
17
|
+
export type SkillInvocation = (typeof SKILL_INVOCATIONS)[number];
|
|
18
|
+
/** AD-046 §3.2: подсказка авто-применения (не разрешение). */
|
|
19
|
+
export declare const SKILL_TRIGGERS: readonly ["manual", "auto"];
|
|
20
|
+
export type SkillTrigger = (typeof SKILL_TRIGGERS)[number];
|
|
21
|
+
/** AD-046 §3.2: применимость скилла по режиму сессии (AD-025). */
|
|
22
|
+
export declare const SKILL_MODES: readonly ["plan", "act", "any"];
|
|
23
|
+
export type SkillMode = (typeof SKILL_MODES)[number];
|
|
24
|
+
/**
|
|
25
|
+
* AD-046 §3.2: нормализованный frontmatter `SKILL.md` (после толерантного парсинга).
|
|
26
|
+
* Неизвестные top-level ключи не теряются — попадают в `extra`.
|
|
27
|
+
*/
|
|
28
|
+
export interface SkillMeta {
|
|
29
|
+
name: string;
|
|
30
|
+
description: string;
|
|
31
|
+
license?: string;
|
|
32
|
+
compatibility?: string;
|
|
33
|
+
/** Свободный контейнер Anthropic/opencode (толерантен к любым ключам). */
|
|
34
|
+
metadata?: Record<string, unknown>;
|
|
35
|
+
/** Claude Code: рекомендуемый whitelist тулов (advisory). */
|
|
36
|
+
allowedTools?: string[];
|
|
37
|
+
whenToUse?: string;
|
|
38
|
+
model?: string;
|
|
39
|
+
agent?: string;
|
|
40
|
+
argumentHint?: string;
|
|
41
|
+
/** default `true`. */
|
|
42
|
+
userInvocable: boolean;
|
|
43
|
+
/** default `false`. */
|
|
44
|
+
disableModelInvocation: boolean;
|
|
45
|
+
/** Вычисляется из двух флагов (§6.1). */
|
|
46
|
+
invocation: SkillInvocation;
|
|
47
|
+
tags?: string[];
|
|
48
|
+
category?: string;
|
|
49
|
+
relatedSkills?: string[];
|
|
50
|
+
requiresCapabilities?: ToolCapability[];
|
|
51
|
+
requiresToolsets?: string[];
|
|
52
|
+
fallbackForCapabilities?: ToolCapability[];
|
|
53
|
+
/** Пусто = все агенты. */
|
|
54
|
+
agents?: string[];
|
|
55
|
+
/** Пусто = все группы. */
|
|
56
|
+
groups?: string[];
|
|
57
|
+
/** Декларативная подсказка; фактический scope задаёт источник. */
|
|
58
|
+
scope?: SkillScope;
|
|
59
|
+
trigger?: SkillTrigger;
|
|
60
|
+
command?: string;
|
|
61
|
+
mode?: SkillMode;
|
|
62
|
+
/** Неизвестные top-level ключи frontmatter (совместимость). */
|
|
63
|
+
extra?: Record<string, unknown>;
|
|
64
|
+
}
|
|
65
|
+
/** Уровень диагностики discovery/валидации. */
|
|
66
|
+
export type SkillDiagnosticLevel = 'error' | 'warning' | 'info';
|
|
67
|
+
/** Код диагностики/проблемы парсинга. */
|
|
68
|
+
export type SkillIssueCode = 'missing-frontmatter' | 'invalid-frontmatter' | 'invalid-frontmatter-type' | 'missing-name' | 'invalid-name' | 'name-mismatch' | 'missing-description' | 'invalid-description' | 'none-invocation' | 'shadowed' | 'untrusted' | 'read-error'
|
|
69
|
+
/** AD-046 §4.2: ошибка удалённого каталога (`skills.urls`): URL/индекс/парсинг. */
|
|
70
|
+
| 'remote';
|
|
71
|
+
/** Проблема парсинга/валидации одного скилла. */
|
|
72
|
+
export interface SkillIssue {
|
|
73
|
+
code: SkillIssueCode;
|
|
74
|
+
message: string;
|
|
75
|
+
/** Путь к файлу (если применимо). */
|
|
76
|
+
path?: string;
|
|
77
|
+
}
|
|
78
|
+
/** Диагностика реестра (видна в `GET /api/v2/skills?diagnostics=1`). */
|
|
79
|
+
export interface SkillDiagnostic extends SkillIssue {
|
|
80
|
+
level: SkillDiagnosticLevel;
|
|
81
|
+
/** Имя скилла (если известно). */
|
|
82
|
+
skill?: string;
|
|
83
|
+
/** Каталог-источник (если известно). */
|
|
84
|
+
dir?: string;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Запись реестра скиллов (AD-046 §4.5). Доступна через API/диагностику; тело
|
|
88
|
+
* скилла в каталог промпта не попадает (progressive disclosure, §5).
|
|
89
|
+
*/
|
|
90
|
+
export interface SkillSummary {
|
|
91
|
+
name: string;
|
|
92
|
+
description: string;
|
|
93
|
+
/** Фактический scope из источника. */
|
|
94
|
+
scope: SkillScope;
|
|
95
|
+
/** Уровень из источника (system/project; session — AD-046 §4.5, Фаза 1 без хранения). */
|
|
96
|
+
level: SkillLevel;
|
|
97
|
+
/** Абсолютный путь каталога скилла. */
|
|
98
|
+
dir: string;
|
|
99
|
+
invocation: SkillInvocation;
|
|
100
|
+
userInvocable: boolean;
|
|
101
|
+
modelInvocable: boolean;
|
|
102
|
+
category?: string;
|
|
103
|
+
tags: string[];
|
|
104
|
+
agents: string[];
|
|
105
|
+
groups: string[];
|
|
106
|
+
requiresCapabilities: string[];
|
|
107
|
+
trusted: boolean;
|
|
108
|
+
/**
|
|
109
|
+
* Capability-aware: `false` — агенту не хватает `requires_capabilities`;
|
|
110
|
+
* скилл виден, но помечен `unavailable` (§6.3).
|
|
111
|
+
*/
|
|
112
|
+
available: boolean;
|
|
113
|
+
unavailableReason?: 'capabilities';
|
|
114
|
+
}
|
|
115
|
+
/** Детали скилла (тело + supporting-файлы). */
|
|
116
|
+
export interface SkillDetail extends SkillSummary {
|
|
117
|
+
meta: SkillMeta;
|
|
118
|
+
body: string;
|
|
119
|
+
/** Относительные пути supporting-файлов (без `SKILL.md`). */
|
|
120
|
+
files: string[];
|
|
121
|
+
}
|
|
122
|
+
/** Параметры capability-aware/binding-фильтра каталога. */
|
|
123
|
+
export interface SkillCatalogFilter {
|
|
124
|
+
/** Привязка агента (id + группы). */
|
|
125
|
+
agent?: {
|
|
126
|
+
id?: string;
|
|
127
|
+
groups?: string[];
|
|
128
|
+
};
|
|
129
|
+
/** Capabilities агента для проверки `requires_capabilities`. */
|
|
130
|
+
capabilities?: readonly string[];
|
|
131
|
+
/** Per-session явное включение имён (volatile, AD-046 §4.5). */
|
|
132
|
+
sessionEnabled?: string[];
|
|
133
|
+
/** Per-session opt-out имён/групп/категорий (volatile). */
|
|
134
|
+
sessionDisabled?: string[];
|
|
135
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AD-046 §2/§4: скиллы — переиспользуемые инструкции (`SKILL.md` + supporting-файлы).
|
|
3
|
+
* Здесь только контракты (типы), без бизнес-логики движка.
|
|
4
|
+
*/
|
|
5
|
+
/** Фактический источник скилла (AD-046 §4.1). */
|
|
6
|
+
export const SKILL_SCOPES = ['instance', 'project'];
|
|
7
|
+
/** Уровень включения скилла (модель AD-071 §2.4/AD-046 §4.5). */
|
|
8
|
+
export const SKILL_LEVELS = ['system', 'project', 'session'];
|
|
9
|
+
/**
|
|
10
|
+
* AD-046 §6.1: способ вызова скилла — комбинация `user-invocable` /
|
|
11
|
+
* `disable-model-invocation`.
|
|
12
|
+
*/
|
|
13
|
+
export const SKILL_INVOCATIONS = ['both', 'user', 'model', 'none'];
|
|
14
|
+
/** AD-046 §3.2: подсказка авто-применения (не разрешение). */
|
|
15
|
+
export const SKILL_TRIGGERS = ['manual', 'auto'];
|
|
16
|
+
/** AD-046 §3.2: применимость скилла по режиму сессии (AD-025). */
|
|
17
|
+
export const SKILL_MODES = ['plan', 'act', 'any'];
|
package/dist/types/tools.d.ts
CHANGED
package/dist/types/tools.js
CHANGED
|
@@ -22,4 +22,3 @@ export const TOOL_CAPABILITY_META = {
|
|
|
22
22
|
[ToolCapability.MCP]: { label: 'MCP-инструменты', description: 'внешние MCP-серверы' },
|
|
23
23
|
[ToolCapability.RUNTIME]: { label: 'Управление сессией', description: 'classify_conversation' },
|
|
24
24
|
};
|
|
25
|
-
//# sourceMappingURL=tools.js.map
|
package/dist/utils/glob.d.ts
CHANGED
package/dist/utils/glob.js
CHANGED
package/dist/utils/index.d.ts
CHANGED
|
@@ -14,6 +14,7 @@ export declare function pickLocalized<V>(record: Record<string, V>, lang: string
|
|
|
14
14
|
export declare function isDefaultTitle(title?: string): boolean;
|
|
15
15
|
export declare function getForkedTitle(title?: string, existingTitles?: string[]): string;
|
|
16
16
|
export { globMatch } from './glob.js';
|
|
17
|
+
export { slugifyWorkspaceName, uniqueWorkspaceName, MAX_WORKSPACE_SLUG_LENGTH } from './workspace.js';
|
|
17
18
|
import type { Part, PartType } from '../types/index.js';
|
|
18
19
|
import type { ProfileStore } from '../interfaces/index.js';
|
|
19
20
|
export declare function makePart(type: PartType, data: unknown): Part;
|
|
@@ -31,4 +32,3 @@ export declare function renderIcon(icon?: string, baseUrl?: string): {
|
|
|
31
32
|
* username). Без профилей возвращает undefined — потребитель подставит username.
|
|
32
33
|
*/
|
|
33
34
|
export declare function createResolveAuthorName(profilesStore?: ProfileStore): ((author: string) => Promise<string | null>) | undefined;
|
|
34
|
-
//# sourceMappingURL=index.d.ts.map
|
package/dist/utils/index.js
CHANGED
|
@@ -92,6 +92,8 @@ export function getForkedTitle(title, existingTitles) {
|
|
|
92
92
|
}
|
|
93
93
|
// --- Glob (permission patterns, AD-029) ---
|
|
94
94
|
export { globMatch } from './glob.js';
|
|
95
|
+
// --- Workspace (AD-075) ---
|
|
96
|
+
export { slugifyWorkspaceName, uniqueWorkspaceName, MAX_WORKSPACE_SLUG_LENGTH } from './workspace.js';
|
|
95
97
|
export function makePart(type, data) {
|
|
96
98
|
return { id: generateId(), type, data };
|
|
97
99
|
}
|
|
@@ -156,4 +158,3 @@ export function createResolveAuthorName(profilesStore) {
|
|
|
156
158
|
return profile ? profile.displayName || profile.username : null;
|
|
157
159
|
};
|
|
158
160
|
}
|
|
159
|
-
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/** Максимальная длина слага каталога workspace (короче лимитов ФС). */
|
|
2
|
+
export declare const MAX_WORKSPACE_SLUG_LENGTH = 64;
|
|
3
|
+
/**
|
|
4
|
+
* Преобразовать имя проекта в безопасное имя каталога: строчная латиница/цифры,
|
|
5
|
+
* разделитель — одиночный дефис; обрезка до `MAX_WORKSPACE_SLUG_LENGTH`.
|
|
6
|
+
* Пустой результат (в т.ч. не-латиница) → `project`.
|
|
7
|
+
*/
|
|
8
|
+
export declare function slugifyWorkspaceName(name: string): string;
|
|
9
|
+
/**
|
|
10
|
+
* Уникальное имя каталога: `base`, при коллизии — `base-2`, `base-3`, …
|
|
11
|
+
* `base` предполагается уже слагифицированным (`slugifyWorkspaceName`).
|
|
12
|
+
*/
|
|
13
|
+
export declare function uniqueWorkspaceName(base: string, existing: readonly string[]): string;
|