@itphx/synth-shared 0.13.8 → 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.
- package/dist/config/defaults.js +74 -2
- package/dist/config/env-overrides.d.ts +16 -0
- package/dist/config/env-overrides.js +103 -3
- package/dist/config/execution-runtime.d.ts +89 -0
- package/dist/config/execution-runtime.js +506 -0
- package/dist/config/execution.d.ts +202 -1
- package/dist/config/execution.js +459 -3
- package/dist/config/index.d.ts +2 -0
- package/dist/config/index.js +2 -0
- package/dist/config/security.d.ts +77 -0
- package/dist/config/security.js +116 -0
- package/dist/config/types.d.ts +466 -34
- package/dist/config/types.js +317 -33
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +196 -13
- package/dist/index.d.ts +5 -4
- package/dist/index.js +15 -2
- package/dist/schemas/index.d.ts +156 -19
- package/dist/schemas/index.js +126 -15
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +29 -1
- package/dist/types/authority.d.ts +10 -0
- package/dist/types/authority.js +8 -0
- package/dist/types/bus-events.d.ts +87 -1
- package/dist/types/catalog.d.ts +1 -1
- package/dist/types/catalog.js +1 -1
- package/dist/types/command-audit.d.ts +91 -0
- package/dist/types/command-audit.js +44 -0
- package/dist/types/commands.d.ts +29 -11
- package/dist/types/commands.js +2 -2
- package/dist/types/egress.d.ts +18 -3
- package/dist/types/egress.js +18 -3
- package/dist/types/events.d.ts +23 -2
- package/dist/types/execution.d.ts +424 -0
- package/dist/types/execution.js +355 -0
- package/dist/types/file-kind.d.ts +3 -2
- package/dist/types/file-kind.js +11 -2
- package/dist/types/git.d.ts +48 -0
- package/dist/types/index.d.ts +6 -0
- package/dist/types/index.js +18 -2
- package/dist/types/mentions.d.ts +96 -0
- package/dist/types/mentions.js +9 -0
- package/dist/types/message.d.ts +24 -1
- package/dist/types/message.js +13 -0
- package/dist/types/pack.d.ts +21 -21
- package/dist/types/pack.js +4 -4
- package/dist/types/permission.d.ts +8 -1
- package/dist/types/pipeline.d.ts +2 -2
- package/dist/types/plugin-protocol.d.ts +203 -4
- package/dist/types/plugin-protocol.js +77 -4
- package/dist/types/project-access.d.ts +94 -0
- package/dist/types/project-access.js +140 -0
- package/dist/types/project.d.ts +59 -2
- package/dist/types/project.js +20 -0
- package/dist/types/schedules.d.ts +49 -3
- package/dist/types/schedules.js +50 -1
- package/dist/types/scripts.d.ts +98 -0
- package/dist/types/scripts.js +14 -0
- package/dist/types/service-keys.d.ts +12 -2
- package/dist/types/service-keys.js +13 -0
- package/dist/types/session.d.ts +60 -3
- package/dist/types/skills.d.ts +15 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/timers.d.ts +402 -0
- package/dist/types/timers.js +166 -0
- package/dist/types/tools.d.ts +124 -1
- package/dist/types/tools.js +22 -0
- package/dist/types/user.d.ts +17 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
|
@@ -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
|
+
}
|