@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.
Files changed (113) hide show
  1. package/dist/config/defaults.d.ts +0 -1
  2. package/dist/config/defaults.js +44 -1
  3. package/dist/config/index.d.ts +0 -1
  4. package/dist/config/index.js +0 -1
  5. package/dist/config/loader.d.ts +2 -1
  6. package/dist/config/loader.js +10 -6
  7. package/dist/config/merge.d.ts +0 -1
  8. package/dist/config/merge.js +0 -1
  9. package/dist/config/resolve.d.ts +35 -7
  10. package/dist/config/resolve.js +98 -19
  11. package/dist/config/types.d.ts +711 -79
  12. package/dist/config/types.js +138 -2
  13. package/dist/i18n/index.d.ts +1 -2
  14. package/dist/i18n/index.js +116 -1
  15. package/dist/index.d.ts +3 -3
  16. package/dist/index.js +3 -3
  17. package/dist/interfaces/index.d.ts +0 -1
  18. package/dist/interfaces/index.js +0 -1
  19. package/dist/model-metadata.d.ts +0 -1
  20. package/dist/model-metadata.js +0 -1
  21. package/dist/protocols/index.d.ts +0 -1
  22. package/dist/protocols/index.js +0 -1
  23. package/dist/schemas/index.d.ts +558 -25
  24. package/dist/schemas/index.js +244 -8
  25. package/dist/skills/frontmatter.d.ts +20 -0
  26. package/dist/skills/frontmatter.js +69 -0
  27. package/dist/types/commands.d.ts +127 -0
  28. package/dist/types/commands.js +10 -0
  29. package/dist/types/index.d.ts +137 -13
  30. package/dist/types/index.js +68 -6
  31. package/dist/types/permission.d.ts +5 -5
  32. package/dist/types/permission.js +0 -1
  33. package/dist/types/skills.d.ts +135 -0
  34. package/dist/types/skills.js +17 -0
  35. package/dist/types/tools.d.ts +0 -1
  36. package/dist/types/tools.js +0 -1
  37. package/dist/utils/glob.d.ts +0 -1
  38. package/dist/utils/glob.js +0 -1
  39. package/dist/utils/index.d.ts +1 -1
  40. package/dist/utils/index.js +2 -1
  41. package/dist/utils/workspace.d.ts +13 -0
  42. package/dist/utils/workspace.js +34 -0
  43. package/dist/version.d.ts +1 -2
  44. package/dist/version.js +1 -2
  45. package/package.json +2 -2
  46. package/dist/config/defaults.d.ts.map +0 -1
  47. package/dist/config/defaults.js.map +0 -1
  48. package/dist/config/defaults.test.d.ts +0 -2
  49. package/dist/config/defaults.test.d.ts.map +0 -1
  50. package/dist/config/defaults.test.js +0 -66
  51. package/dist/config/defaults.test.js.map +0 -1
  52. package/dist/config/index.d.ts.map +0 -1
  53. package/dist/config/index.js.map +0 -1
  54. package/dist/config/loader.d.ts.map +0 -1
  55. package/dist/config/loader.js.map +0 -1
  56. package/dist/config/loader.test.d.ts +0 -2
  57. package/dist/config/loader.test.d.ts.map +0 -1
  58. package/dist/config/loader.test.js +0 -43
  59. package/dist/config/loader.test.js.map +0 -1
  60. package/dist/config/merge.d.ts.map +0 -1
  61. package/dist/config/merge.js.map +0 -1
  62. package/dist/config/merge.test.d.ts +0 -2
  63. package/dist/config/merge.test.d.ts.map +0 -1
  64. package/dist/config/merge.test.js +0 -49
  65. package/dist/config/merge.test.js.map +0 -1
  66. package/dist/config/resolve.d.ts.map +0 -1
  67. package/dist/config/resolve.js.map +0 -1
  68. package/dist/config/resolve.test.d.ts +0 -2
  69. package/dist/config/resolve.test.d.ts.map +0 -1
  70. package/dist/config/resolve.test.js +0 -81
  71. package/dist/config/resolve.test.js.map +0 -1
  72. package/dist/config/types.d.ts.map +0 -1
  73. package/dist/config/types.js.map +0 -1
  74. package/dist/config/types.test.d.ts +0 -2
  75. package/dist/config/types.test.d.ts.map +0 -1
  76. package/dist/config/types.test.js +0 -63
  77. package/dist/config/types.test.js.map +0 -1
  78. package/dist/i18n/index.d.ts.map +0 -1
  79. package/dist/i18n/index.js.map +0 -1
  80. package/dist/i18n/index.test.d.ts +0 -2
  81. package/dist/i18n/index.test.d.ts.map +0 -1
  82. package/dist/i18n/index.test.js +0 -41
  83. package/dist/i18n/index.test.js.map +0 -1
  84. package/dist/index.d.ts.map +0 -1
  85. package/dist/index.js.map +0 -1
  86. package/dist/interfaces/index.d.ts.map +0 -1
  87. package/dist/interfaces/index.js.map +0 -1
  88. package/dist/model-metadata.d.ts.map +0 -1
  89. package/dist/model-metadata.js.map +0 -1
  90. package/dist/model-metadata.test.d.ts +0 -2
  91. package/dist/model-metadata.test.d.ts.map +0 -1
  92. package/dist/model-metadata.test.js +0 -53
  93. package/dist/model-metadata.test.js.map +0 -1
  94. package/dist/protocols/index.d.ts.map +0 -1
  95. package/dist/protocols/index.js.map +0 -1
  96. package/dist/schemas/index.d.ts.map +0 -1
  97. package/dist/schemas/index.js.map +0 -1
  98. package/dist/types/index.d.ts.map +0 -1
  99. package/dist/types/index.js.map +0 -1
  100. package/dist/types/permission.d.ts.map +0 -1
  101. package/dist/types/permission.js.map +0 -1
  102. package/dist/types/tools.d.ts.map +0 -1
  103. package/dist/types/tools.js.map +0 -1
  104. package/dist/utils/glob.d.ts.map +0 -1
  105. package/dist/utils/glob.js.map +0 -1
  106. package/dist/utils/index.d.ts.map +0 -1
  107. package/dist/utils/index.js.map +0 -1
  108. package/dist/utils/index.test.d.ts +0 -2
  109. package/dist/utils/index.test.d.ts.map +0 -1
  110. package/dist/utils/index.test.js +0 -150
  111. package/dist/utils/index.test.js.map +0 -1
  112. package/dist/version.d.ts.map +0 -1
  113. package/dist/version.js.map +0 -1
@@ -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,5 @@ export interface FsError {
970
1093
  }
971
1094
  export * from './tools.js';
972
1095
  export * from './permission.js';
973
- //# sourceMappingURL=index.d.ts.map
1096
+ export * from './skills.js';
1097
+ export * from './commands.js';
@@ -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
- * - `config` — выключен в конфиге записи (`config.enabled === false`);
85
+ * - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
86
+ * - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
86
87
  * - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
87
- * - `project_disabled` — проектный сервер не включён в проекте (`project.defaultOn`);
88
- * - `not_default` — нет `enabledByDefault` и не включён явно.
88
+ * - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
89
+ *
90
+ * Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
91
+ * реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
89
92
  */
90
93
  export const MCP_DISABLED_REASONS = [
91
- 'session_optout',
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
- //# sourceMappingURL=index.js.map
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`) или роли агента (`role`). Отличие от `deny`-политики:
42
- * доступ открывается переключением режима / делегированием другому агенту,
43
- * поэтому модель получает соответствующую подсказку (messageId).
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
@@ -19,4 +19,3 @@ export const permissionConfigSchema = z.object({
19
19
  rules: z.record(z.string(), permissionRuleSchema).default({}),
20
20
  askTimeoutMs: z.number().int().min(0).default(30_000),
21
21
  });
22
- //# sourceMappingURL=permission.js.map
@@ -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'];
@@ -71,4 +71,3 @@ export interface CompletedToolCall {
71
71
  startedAt: string;
72
72
  completedAt: string;
73
73
  }
74
- //# sourceMappingURL=tools.d.ts.map
@@ -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
@@ -14,4 +14,3 @@
14
14
  * Паттерн и путь нормализуются (backslash → '/', без завершающего '/').
15
15
  */
16
16
  export declare function globMatch(pattern: string, value: string): boolean;
17
- //# sourceMappingURL=glob.d.ts.map
@@ -110,4 +110,3 @@ export function globMatch(pattern, value) {
110
110
  return v === '';
111
111
  return matchSegments(p.split('/'), v.split('/'));
112
112
  }
113
- //# sourceMappingURL=glob.js.map
@@ -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
@@ -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;