@itphx/synth-shared 0.13.4 → 0.13.10

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 (89) hide show
  1. package/dist/config/defaults.js +102 -3
  2. package/dist/config/env-overrides.d.ts +39 -4
  3. package/dist/config/env-overrides.js +174 -4
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +3 -0
  9. package/dist/config/index.js +3 -0
  10. package/dist/config/loader.d.ts +8 -0
  11. package/dist/config/loader.js +6 -1
  12. package/dist/config/redact.d.ts +22 -0
  13. package/dist/config/redact.js +53 -0
  14. package/dist/config/security.d.ts +77 -0
  15. package/dist/config/security.js +116 -0
  16. package/dist/config/tls.d.ts +7 -4
  17. package/dist/config/tls.js +10 -23
  18. package/dist/config/types.d.ts +568 -38
  19. package/dist/config/types.js +390 -33
  20. package/dist/i18n/index.d.ts +1 -1
  21. package/dist/i18n/index.js +325 -13
  22. package/dist/index.d.ts +7 -6
  23. package/dist/index.js +17 -4
  24. package/dist/model-metadata.d.ts +10 -0
  25. package/dist/model-metadata.js +10 -0
  26. package/dist/schemas/index.d.ts +444 -30
  27. package/dist/schemas/index.js +354 -17
  28. package/dist/skills/frontmatter.js +1 -1
  29. package/dist/types/agent.d.ts +29 -1
  30. package/dist/types/authority.d.ts +10 -0
  31. package/dist/types/authority.js +8 -0
  32. package/dist/types/bus-events.d.ts +88 -2
  33. package/dist/types/catalog.d.ts +1 -1
  34. package/dist/types/catalog.js +1 -1
  35. package/dist/types/command-audit.d.ts +91 -0
  36. package/dist/types/command-audit.js +44 -0
  37. package/dist/types/commands.d.ts +29 -11
  38. package/dist/types/commands.js +2 -2
  39. package/dist/types/egress.d.ts +18 -3
  40. package/dist/types/egress.js +18 -3
  41. package/dist/types/events.d.ts +23 -2
  42. package/dist/types/execution.d.ts +424 -0
  43. package/dist/types/execution.js +355 -0
  44. package/dist/types/file-kind.d.ts +3 -2
  45. package/dist/types/file-kind.js +11 -2
  46. package/dist/types/git.d.ts +131 -0
  47. package/dist/types/git.js +101 -1
  48. package/dist/types/host-pattern.d.ts +41 -0
  49. package/dist/types/host-pattern.js +143 -0
  50. package/dist/types/index.d.ts +8 -0
  51. package/dist/types/index.js +25 -3
  52. package/dist/types/maintenance.d.ts +1 -1
  53. package/dist/types/mcp.d.ts +90 -0
  54. package/dist/types/mcp.js +11 -0
  55. package/dist/types/mentions.d.ts +96 -0
  56. package/dist/types/mentions.js +9 -0
  57. package/dist/types/message-stream.d.ts +41 -0
  58. package/dist/types/message.d.ts +24 -1
  59. package/dist/types/message.js +13 -0
  60. package/dist/types/pack.d.ts +21 -21
  61. package/dist/types/pack.js +4 -4
  62. package/dist/types/permission.d.ts +20 -3
  63. package/dist/types/pipeline.d.ts +2 -2
  64. package/dist/types/plugin-protocol.d.ts +203 -4
  65. package/dist/types/plugin-protocol.js +77 -4
  66. package/dist/types/project-access.d.ts +94 -0
  67. package/dist/types/project-access.js +140 -0
  68. package/dist/types/project.d.ts +89 -2
  69. package/dist/types/project.js +36 -0
  70. package/dist/types/prompt.d.ts +4 -2
  71. package/dist/types/schedules.d.ts +49 -3
  72. package/dist/types/schedules.js +50 -1
  73. package/dist/types/scripts.d.ts +98 -0
  74. package/dist/types/scripts.js +14 -0
  75. package/dist/types/service-keys.d.ts +16 -3
  76. package/dist/types/service-keys.js +19 -1
  77. package/dist/types/session.d.ts +68 -3
  78. package/dist/types/skills.d.ts +21 -11
  79. package/dist/types/skills.js +6 -6
  80. package/dist/types/timers.d.ts +402 -0
  81. package/dist/types/timers.js +166 -0
  82. package/dist/types/tools.d.ts +160 -1
  83. package/dist/types/tools.js +70 -0
  84. package/dist/types/user.d.ts +24 -0
  85. package/dist/types/worktree.d.ts +1 -1
  86. package/dist/utils/index.js +1 -1
  87. package/dist/version.d.ts +1 -1
  88. package/dist/version.js +1 -1
  89. package/package.json +3 -2
@@ -0,0 +1,77 @@
1
+ /**
2
+ * ADR-023: резолвер защиты от indirect prompt injection (`security.promptInjection`).
3
+ *
4
+ * Приоритет эффективного значения — **env > runtime (`settings.json`/PG) >
5
+ * config.yaml > дефолт схемы** (`enabled: true`, `wrapContent: true`,
6
+ * `mode: 'flag'`).
7
+ *
8
+ * `wrapContent` runtime-настройкой **не управляется**: это deployment-политика
9
+ * обёртки tool-контента (`[CONTENT | SOURCE: … | trust: …]`), она берётся из
10
+ * config.yaml (или дефолта), а не из UI.
11
+ *
12
+ * Env-ключи (`SYNTH_SECURITY_PROMPT_INJECTION_ENABLED`/`…_MODE`) намеренно
13
+ * **не** входят в `ENV_OVERRIDES` (`env-overrides.ts`): там только двухуровневые
14
+ * пути `<section>.<key>`, а у `promptInjection` два поля и нужен
15
+ * `envLockedFields` (фиксация проверяется **по полю**, как у `resolveSshMode`).
16
+ * Невалидное env-значение — warn + игнор (fail-soft).
17
+ */
18
+ import type { PromptInjectionConfig } from './types.js';
19
+ /** Режим детекции подозрительных паттернов (канон схемы). */
20
+ export type PromptInjectionMode = PromptInjectionConfig['mode'];
21
+ /** Канонические режимы (для валидации env/API). */
22
+ export declare const PROMPT_INJECTION_MODES: readonly PromptInjectionMode[];
23
+ /** Поля секции, управляемые runtime-настройкой (и env-фиксацией). */
24
+ export type PromptInjectionField = 'enabled' | 'mode';
25
+ /** Канонический порядок полей (для `envLockedFields` и обхода). */
26
+ export declare const PROMPT_INJECTION_FIELDS: readonly PromptInjectionField[];
27
+ /**
28
+ * Runtime-патч защиты от prompt injection (раздел «Безопасность» в UI).
29
+ *
30
+ * `wrapContent` сюда не входит осознанно — runtime его не перекрывает.
31
+ */
32
+ export interface PromptInjectionRuntimePatch {
33
+ enabled?: boolean;
34
+ mode?: PromptInjectionMode;
35
+ }
36
+ /** Источник эффективного значения (по полям, наиболее специфичный). */
37
+ export type PromptInjectionSource = 'env' | 'runtime' | 'config' | 'default';
38
+ /** Результат резолвинга `security.promptInjection` (env > runtime > config > default). */
39
+ export interface ResolvedPromptInjectionConfig {
40
+ /** Эффективная секция (все поля заданы) — её читают guard и оркестратор. */
41
+ config: PromptInjectionConfig;
42
+ /** Наиболее специфичный источник среди полей `enabled`/`mode`. */
43
+ source: PromptInjectionSource;
44
+ /** Хотя бы одно поле задано через env: runtime его не перекрывает. */
45
+ envLocked: boolean;
46
+ /** Поля, зафиксированные env: из UI они `disabled` и не уходят в `PUT`. */
47
+ envLockedFields: PromptInjectionField[];
48
+ /** База без runtime и env (к чему вернёт сброс) — для `defaults` в ответе API. */
49
+ defaults: PromptInjectionConfig;
50
+ }
51
+ /** Env-имя выключателя защиты (ADR-023). */
52
+ export declare const PROMPT_INJECTION_ENABLED_ENV = "SYNTH_SECURITY_PROMPT_INJECTION_ENABLED";
53
+ /** Env-имя режима детекции (ADR-023). */
54
+ export declare const PROMPT_INJECTION_MODE_ENV = "SYNTH_SECURITY_PROMPT_INJECTION_MODE";
55
+ /** Дефолты схемы — совпадают с `defaultConfig.security.promptInjection`. */
56
+ export declare const DEFAULT_PROMPT_INJECTION_CONFIG: PromptInjectionConfig;
57
+ /** Прочитать boolean из env (`true`/`1`, `false`/`0`); пусто/невалидно — «не задано». */
58
+ export declare function parsePromptInjectionEnabledEnv(env?: NodeJS.ProcessEnv): boolean | undefined;
59
+ /** Прочитать режим из env; невалидное — warn + игнор (fail-soft). */
60
+ export declare function parsePromptInjectionModeEnv(env?: NodeJS.ProcessEnv): PromptInjectionMode | undefined;
61
+ /**
62
+ * Эффективная секция `security.promptInjection` — приоритет
63
+ * **env > runtime > config.yaml > дефолт схемы**.
64
+ *
65
+ * **«Задано явно» vs «дефолт».** Схема конфига префилит секцию
66
+ * (`promptInjectionConfigSchema.prefault({})`), поэтому на чистом инстансе
67
+ * `config` уже равен дефолтам — хотя в `config.yaml` значений нет. Поле,
68
+ * значение которого равно дефолту схемы, отдаётся с `source:'default'`
69
+ * (UI показывает бейдж «по умолчанию»); явное значение в конфиге, совпавшее с
70
+ * дефолтом, неотличимо от его отсутствия — эффективное значение одно и то же
71
+ * (тот же приём, что у `resolveBackgroundConfig`/`resolveSessionOpsPerMinute`).
72
+ *
73
+ * Функция чистая (без I/O): её читают точка сборки (старт процесса), роут
74
+ * `/api/v2/settings/security` и live-применение из UI — расхождений в
75
+ * приоритете быть не должно.
76
+ */
77
+ export declare function resolvePromptInjection(config?: Partial<PromptInjectionConfig>, runtime?: PromptInjectionRuntimePatch, env?: NodeJS.ProcessEnv): ResolvedPromptInjectionConfig;
@@ -0,0 +1,116 @@
1
+ /** Канонические режимы (для валидации env/API). */
2
+ export const PROMPT_INJECTION_MODES = ['flag', 'sanitize', 'block'];
3
+ /** Канонический порядок полей (для `envLockedFields` и обхода). */
4
+ export const PROMPT_INJECTION_FIELDS = ['enabled', 'mode'];
5
+ /** Env-имя выключателя защиты (ADR-023). */
6
+ export const PROMPT_INJECTION_ENABLED_ENV = 'SYNTH_SECURITY_PROMPT_INJECTION_ENABLED';
7
+ /** Env-имя режима детекции (ADR-023). */
8
+ export const PROMPT_INJECTION_MODE_ENV = 'SYNTH_SECURITY_PROMPT_INJECTION_MODE';
9
+ /** Дефолты схемы — совпадают с `defaultConfig.security.promptInjection`. */
10
+ export const DEFAULT_PROMPT_INJECTION_CONFIG = {
11
+ enabled: true,
12
+ wrapContent: true,
13
+ mode: 'flag',
14
+ };
15
+ /** Прочитать boolean из env (`true`/`1`, `false`/`0`); пусто/невалидно — «не задано». */
16
+ export function parsePromptInjectionEnabledEnv(env = process.env) {
17
+ const raw = env[PROMPT_INJECTION_ENABLED_ENV];
18
+ if (raw === undefined || raw.trim() === '')
19
+ return undefined;
20
+ const value = raw.trim().toLowerCase();
21
+ if (value === 'true' || value === '1')
22
+ return true;
23
+ if (value === 'false' || value === '0')
24
+ return false;
25
+ console.warn(`[config] невалидное значение ${PROMPT_INJECTION_ENABLED_ENV}="${raw}" (ожидается boolean) — игнорируется`);
26
+ return undefined;
27
+ }
28
+ /** Прочитать режим из env; невалидное — warn + игнор (fail-soft). */
29
+ export function parsePromptInjectionModeEnv(env = process.env) {
30
+ const raw = env[PROMPT_INJECTION_MODE_ENV];
31
+ if (raw === undefined || raw.trim() === '')
32
+ return undefined;
33
+ const value = raw.trim();
34
+ if (PROMPT_INJECTION_MODES.includes(value)) {
35
+ return value;
36
+ }
37
+ console.warn(`[config] невалидное значение ${PROMPT_INJECTION_MODE_ENV}="${raw}" (ожидается ${PROMPT_INJECTION_MODES.join('|')}) — игнорируется`);
38
+ return undefined;
39
+ }
40
+ /**
41
+ * Эффективная секция `security.promptInjection` — приоритет
42
+ * **env > runtime > config.yaml > дефолт схемы**.
43
+ *
44
+ * **«Задано явно» vs «дефолт».** Схема конфига префилит секцию
45
+ * (`promptInjectionConfigSchema.prefault({})`), поэтому на чистом инстансе
46
+ * `config` уже равен дефолтам — хотя в `config.yaml` значений нет. Поле,
47
+ * значение которого равно дефолту схемы, отдаётся с `source:'default'`
48
+ * (UI показывает бейдж «по умолчанию»); явное значение в конфиге, совпавшее с
49
+ * дефолтом, неотличимо от его отсутствия — эффективное значение одно и то же
50
+ * (тот же приём, что у `resolveBackgroundConfig`/`resolveSessionOpsPerMinute`).
51
+ *
52
+ * Функция чистая (без I/O): её читают точка сборки (старт процесса), роут
53
+ * `/api/v2/settings/security` и live-применение из UI — расхождений в
54
+ * приоритете быть не должно.
55
+ */
56
+ export function resolvePromptInjection(config, runtime, env = process.env) {
57
+ const envEnabled = parsePromptInjectionEnabledEnv(env);
58
+ const envMode = parsePromptInjectionModeEnv(env);
59
+ const configEnabled = config?.enabled;
60
+ const configMode = config?.mode;
61
+ const runtimeEnabled = runtime?.enabled;
62
+ const runtimeMode = runtime?.mode;
63
+ const sources = {
64
+ enabled: 'default',
65
+ mode: 'default',
66
+ };
67
+ const effective = {
68
+ enabled: DEFAULT_PROMPT_INJECTION_CONFIG.enabled,
69
+ mode: DEFAULT_PROMPT_INJECTION_CONFIG.mode,
70
+ };
71
+ if (envEnabled !== undefined) {
72
+ effective.enabled = envEnabled;
73
+ sources.enabled = 'env';
74
+ }
75
+ else if (runtimeEnabled !== undefined) {
76
+ effective.enabled = runtimeEnabled;
77
+ sources.enabled = 'runtime';
78
+ }
79
+ else if (configEnabled !== undefined &&
80
+ configEnabled !== DEFAULT_PROMPT_INJECTION_CONFIG.enabled) {
81
+ effective.enabled = configEnabled;
82
+ sources.enabled = 'config';
83
+ }
84
+ if (envMode !== undefined) {
85
+ effective.mode = envMode;
86
+ sources.mode = 'env';
87
+ }
88
+ else if (runtimeMode !== undefined) {
89
+ effective.mode = runtimeMode;
90
+ sources.mode = 'runtime';
91
+ }
92
+ else if (configMode !== undefined && configMode !== DEFAULT_PROMPT_INJECTION_CONFIG.mode) {
93
+ effective.mode = configMode;
94
+ sources.mode = 'config';
95
+ }
96
+ const envLockedFields = PROMPT_INJECTION_FIELDS.filter((field) => sources[field] === 'env');
97
+ const order = ['env', 'runtime', 'config', 'default'];
98
+ const source = order.find((layer) => PROMPT_INJECTION_FIELDS.some((f) => sources[f] === layer))
99
+ ?? 'default';
100
+ return {
101
+ config: {
102
+ enabled: effective.enabled,
103
+ // `wrapContent` — только база (config.yaml/дефолт), runtime не управляет.
104
+ wrapContent: config?.wrapContent ?? DEFAULT_PROMPT_INJECTION_CONFIG.wrapContent,
105
+ mode: effective.mode,
106
+ },
107
+ source,
108
+ envLocked: envLockedFields.length > 0,
109
+ envLockedFields,
110
+ defaults: {
111
+ enabled: configEnabled ?? DEFAULT_PROMPT_INJECTION_CONFIG.enabled,
112
+ wrapContent: config?.wrapContent ?? DEFAULT_PROMPT_INJECTION_CONFIG.wrapContent,
113
+ mode: configMode ?? DEFAULT_PROMPT_INJECTION_CONFIG.mode,
114
+ },
115
+ };
116
+ }
@@ -1,4 +1,6 @@
1
1
  import type { SecurityTlsConfig } from './types.js';
2
+ import { matchTlsHostPattern, normalizeTlsHost } from '../types/host-pattern.js';
3
+ export { matchTlsHostPattern, normalizeTlsHost };
2
4
  /** Минимальный срез конфига, достаточный резолверу (совместим с `SynthConfig`). */
3
5
  export interface TlsConfigSource {
4
6
  security?: {
@@ -119,10 +121,11 @@ export declare function resolveTlsProfiles(config: TlsConfigSource | undefined,
119
121
  * маппингов, затем профиль по умолчанию, иначе `undefined` (без клиентского серта).
120
122
  */
121
123
  export declare function selectTlsClientProfile(profiles: Pick<ResolvedTlsProfiles, 'default' | 'mappings'>, host: string | undefined): TlsClientProfile | undefined;
122
- /** Матчинг одного паттерна (`host` | `*.suffix` | `*`); регистронезависимо. */
123
- export declare function matchTlsHostPattern(pattern: string, rawHost: string): boolean;
124
- /** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
125
- export declare function normalizeTlsHost(rawHost: string | undefined): string | undefined;
124
+ /**
125
+ * ADR-099: семантика шаблона хоста — общая (см. `types/host-pattern.ts`):
126
+ * `normalizeTlsHost`/`matchTlsHostPattern` переиспользуются оттуда, второй
127
+ * матчер в подсистемах не заводится.
128
+ */
126
129
  /**
127
130
  * Эффективное доверие с прочитанным CA. Fail-closed: `caFile` задан, но файл
128
131
  * отсутствует/не читается/не PEM → внятная ошибка (никакого тихого фоллбэка на
@@ -11,6 +11,11 @@
11
11
  */
12
12
  import { readFileSync } from 'node:fs';
13
13
  import { isIP } from 'node:net';
14
+ // ADR-099: семантика шаблона хоста — общая для всех подсистем (TLS, egress,
15
+ // SSH-политика PROP-124). Реализация живёт в browser-safe модуле
16
+ // `types/host-pattern.ts` (его читает и UI) — второй матчер не заводим.
17
+ import { matchTlsHostPattern, normalizeTlsHost } from '../types/host-pattern.js';
18
+ export { matchTlsHostPattern, normalizeTlsHost };
14
19
  /** Env-имена секции `security.tls` (ADR-023). */
15
20
  export const TLS_ENV = {
16
21
  caFile: 'SYNTH_TLS_CA_FILE',
@@ -155,29 +160,11 @@ export function selectTlsClientProfile(profiles, host) {
155
160
  }
156
161
  return profiles.default;
157
162
  }
158
- /** Матчинг одного паттерна (`host` | `*.suffix` | `*`); регистронезависимо. */
159
- export function matchTlsHostPattern(pattern, rawHost) {
160
- const host = normalizeTlsHost(rawHost);
161
- if (host === undefined)
162
- return false;
163
- const value = pattern.trim().toLowerCase().replace(/\.$/, '');
164
- if (value === '*')
165
- return true;
166
- if (value.startsWith('*.')) {
167
- const suffix = value.slice(2);
168
- return suffix !== '' && host.endsWith(`.${suffix}`);
169
- }
170
- return host === value;
171
- }
172
- /** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
173
- export function normalizeTlsHost(rawHost) {
174
- if (typeof rawHost !== 'string')
175
- return undefined;
176
- let host = rawHost.trim().toLowerCase().replace(/\.$/, '');
177
- if (host.startsWith('[') && host.endsWith(']'))
178
- host = host.slice(1, -1);
179
- return host === '' ? undefined : host;
180
- }
163
+ /**
164
+ * ADR-099: семантика шаблона хоста — общая (см. `types/host-pattern.ts`):
165
+ * `normalizeTlsHost`/`matchTlsHostPattern` переиспользуются оттуда, второй
166
+ * матчер в подсистемах не заводится.
167
+ */
181
168
  /**
182
169
  * Эффективное доверие с прочитанным CA. Fail-closed: `caFile` задан, но файл
183
170
  * отсутствует/не читается/не PEM → внятная ошибка (никакого тихого фоллбэка на