@itphx/synth-shared 0.12.4 → 0.13.8
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 +125 -5
- package/dist/config/env-overrides.d.ts +23 -4
- package/dist/config/env-overrides.js +103 -4
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/loader.d.ts +8 -0
- package/dist/config/loader.js +6 -1
- package/dist/config/redact.d.ts +22 -0
- package/dist/config/redact.js +53 -0
- package/dist/config/resolve.d.ts +17 -0
- package/dist/config/resolve.js +40 -1
- package/dist/config/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +496 -11
- package/dist/config/types.js +348 -6
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +317 -3
- package/dist/index.d.ts +4 -4
- package/dist/index.js +4 -4
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +378 -21
- package/dist/schemas/index.js +282 -5
- package/dist/types/agent.d.ts +8 -1
- package/dist/types/bus-events.d.ts +60 -2
- package/dist/types/egress.d.ts +2 -2
- package/dist/types/egress.js +2 -2
- package/dist/types/file-kind.d.ts +40 -0
- package/dist/types/file-kind.js +157 -0
- package/dist/types/fs.d.ts +54 -1
- package/dist/types/fs.js +43 -0
- package/dist/types/git.d.ts +88 -0
- package/dist/types/git.js +101 -1
- package/dist/types/host-pattern.d.ts +41 -0
- package/dist/types/host-pattern.js +143 -0
- package/dist/types/index.d.ts +4 -0
- package/dist/types/index.js +13 -1
- package/dist/types/llm.d.ts +95 -0
- package/dist/types/llm.js +58 -0
- package/dist/types/maintenance.d.ts +1 -1
- package/dist/types/mcp.d.ts +90 -0
- package/dist/types/mcp.js +11 -0
- package/dist/types/message-stream.d.ts +389 -0
- package/dist/types/message-stream.js +41 -0
- package/dist/types/message.d.ts +49 -0
- package/dist/types/pack.d.ts +6 -6
- package/dist/types/permission.d.ts +39 -3
- package/dist/types/pipeline-engine.d.ts +2 -2
- package/dist/types/project.d.ts +30 -0
- package/dist/types/project.js +16 -0
- package/dist/types/prompt.d.ts +4 -2
- package/dist/types/provider.d.ts +280 -0
- package/dist/types/provider.js +289 -0
- package/dist/types/service-keys.d.ts +6 -3
- package/dist/types/service-keys.js +6 -1
- package/dist/types/session.d.ts +178 -3
- package/dist/types/skills.d.ts +6 -0
- package/dist/types/tools.d.ts +57 -0
- package/dist/types/tools.js +49 -1
- package/dist/types/user.d.ts +7 -0
- package/dist/types/worktree.d.ts +1 -1
- package/dist/utils/index.js +1 -1
- package/dist/utils/reasoning.d.ts +18 -2
- package/dist/utils/reasoning.js +16 -7
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +4 -3
package/dist/types/tools.d.ts
CHANGED
|
@@ -65,6 +65,42 @@ export declare const ToolCapability: {
|
|
|
65
65
|
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
66
66
|
*/
|
|
67
67
|
readonly MODELS: "models";
|
|
68
|
+
/**
|
|
69
|
+
* Адресный SSH-доступ (PROP-124 §4): тулы, обращающиеся к удалённому хосту
|
|
70
|
+
* по SSH (`ssh_exec` и дальше `ssh_copy`/`ssh_tunnel`).
|
|
71
|
+
*
|
|
72
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
73
|
+
* адресный SSH — доменный ресурс инстанса (реестр ключей + политика
|
|
74
|
+
* хостов/портов), а не примитив ядра. Capability **не** привязана к рабочему
|
|
75
|
+
* каталогу проекта, но **зависит от режима инстанса** `ssh.mode`: в режиме
|
|
76
|
+
* `agent` адресные тулы недоступны (`unavailable(policy)`), см.
|
|
77
|
+
* `engine/permission/availability.ts`.
|
|
78
|
+
*/
|
|
79
|
+
readonly SSH: "ssh";
|
|
80
|
+
/**
|
|
81
|
+
* Список задач сессии (ADR-039): тулы `todo_write`/`todo_list`/`todo_add`/
|
|
82
|
+
* `todo_update`/`todo_delete`.
|
|
83
|
+
*
|
|
84
|
+
* Это **операционный список задач сессии** (`session.todos`), а не план
|
|
85
|
+
* проекта (`project.plan`, тулы `plan_*`). Capability выдаётся **в
|
|
86
|
+
* дополнение** к `runtime` (совместимость с существующими/кастомными
|
|
87
|
+
* агентами): группа `runtime` продолжает матчить todo-тулы (имена остаются в
|
|
88
|
+
* `RUNTIME_TOOLS`), а правило `permission.rules.todo` работает по capability.
|
|
89
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
90
|
+
* (`WORKSPACE_CAPABILITIES`) — список задач доступен и без workspace.
|
|
91
|
+
*/
|
|
92
|
+
readonly TODO: "todo";
|
|
93
|
+
/**
|
|
94
|
+
* Инстанс и MCP-реестр (read-only, Workstream A1): тулы `synth_info`,
|
|
95
|
+
* `synth_mcp_list`, `synth_mcp_test`.
|
|
96
|
+
*
|
|
97
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/
|
|
98
|
+
* `process`/`models`: инстанс и его MCP-реестр — доменный ресурс, а не
|
|
99
|
+
* примитив ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
100
|
+
* (`WORKSPACE_CAPABILITIES`) — сведения об инстансе доступны и без workspace.
|
|
101
|
+
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
102
|
+
*/
|
|
103
|
+
readonly INSTANCE: "instance";
|
|
68
104
|
};
|
|
69
105
|
export type ToolCapability = (typeof ToolCapability)[keyof typeof ToolCapability];
|
|
70
106
|
export declare const TOOL_CAPABILITY_META: Record<string, {
|
|
@@ -84,6 +120,18 @@ export interface ToolContext {
|
|
|
84
120
|
*/
|
|
85
121
|
projectId?: string;
|
|
86
122
|
workingDir: string;
|
|
123
|
+
/**
|
|
124
|
+
* Дополнительные абсолютные корни, внутри которых файловые/поисковые/shell-
|
|
125
|
+
* и git-тулы считаются «своими» (perimeter сессии).
|
|
126
|
+
*
|
|
127
|
+
* `workingDir` остаётся **базой для относительных** путей (и каталогом
|
|
128
|
+
* исполнения shell/git): относительный путь резолвится от него. Containment
|
|
129
|
+
* же проверяется по `workingDir` + `allowedRoots` — так сессия в git-worktree
|
|
130
|
+
* (ADR-114) видит и рабочий каталог worktree, и корень проекта
|
|
131
|
+
* (`project.workspace`), как в opencode (`FileAccess.resolve`:
|
|
132
|
+
* internal = location.directory ИЛИ project worktree).
|
|
133
|
+
*/
|
|
134
|
+
allowedRoots?: string[];
|
|
87
135
|
/**
|
|
88
136
|
* ADR-114: привязка сессии к git-worktree.
|
|
89
137
|
*
|
|
@@ -157,6 +205,15 @@ export interface ToolDefinition {
|
|
|
157
205
|
capabilities: ToolCapability[];
|
|
158
206
|
execute: ToolExecutor;
|
|
159
207
|
jsonSchema?: Record<string, unknown>;
|
|
208
|
+
/**
|
|
209
|
+
* Нормализация аргументов **до** zod-валидации — терпимость к типовым обёрткам
|
|
210
|
+
* слабых моделей (`{todos: {item: …}}` вместо `{todos: …}`).
|
|
211
|
+
*
|
|
212
|
+
* На JSON Schema не влияет (схема для модели остаётся прежней); вызывается
|
|
213
|
+
* один раз в `executeToolDef` перед `safeParse`, возвращает аргументы для
|
|
214
|
+
* проверки. Аддитивное поле: тул без него работает как прежде.
|
|
215
|
+
*/
|
|
216
|
+
normalizeArgs?: (args: Record<string, unknown>) => Record<string, unknown>;
|
|
160
217
|
/** ADR-071 §2.1: источник инструмента (builtin/mcp/plugin). */
|
|
161
218
|
source?: ToolSource;
|
|
162
219
|
/** ADR-071 §2.1: имя MCP-сервера для `source: 'mcp'`. */
|
package/dist/types/tools.js
CHANGED
|
@@ -64,6 +64,42 @@ export const ToolCapability = {
|
|
|
64
64
|
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
65
65
|
*/
|
|
66
66
|
MODELS: 'models',
|
|
67
|
+
/**
|
|
68
|
+
* Адресный SSH-доступ (PROP-124 §4): тулы, обращающиеся к удалённому хосту
|
|
69
|
+
* по SSH (`ssh_exec` и дальше `ssh_copy`/`ssh_tunnel`).
|
|
70
|
+
*
|
|
71
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
72
|
+
* адресный SSH — доменный ресурс инстанса (реестр ключей + политика
|
|
73
|
+
* хостов/портов), а не примитив ядра. Capability **не** привязана к рабочему
|
|
74
|
+
* каталогу проекта, но **зависит от режима инстанса** `ssh.mode`: в режиме
|
|
75
|
+
* `agent` адресные тулы недоступны (`unavailable(policy)`), см.
|
|
76
|
+
* `engine/permission/availability.ts`.
|
|
77
|
+
*/
|
|
78
|
+
SSH: 'ssh',
|
|
79
|
+
/**
|
|
80
|
+
* Список задач сессии (ADR-039): тулы `todo_write`/`todo_list`/`todo_add`/
|
|
81
|
+
* `todo_update`/`todo_delete`.
|
|
82
|
+
*
|
|
83
|
+
* Это **операционный список задач сессии** (`session.todos`), а не план
|
|
84
|
+
* проекта (`project.plan`, тулы `plan_*`). Capability выдаётся **в
|
|
85
|
+
* дополнение** к `runtime` (совместимость с существующими/кастомными
|
|
86
|
+
* агентами): группа `runtime` продолжает матчить todo-тулы (имена остаются в
|
|
87
|
+
* `RUNTIME_TOOLS`), а правило `permission.rules.todo` работает по capability.
|
|
88
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
89
|
+
* (`WORKSPACE_CAPABILITIES`) — список задач доступен и без workspace.
|
|
90
|
+
*/
|
|
91
|
+
TODO: 'todo',
|
|
92
|
+
/**
|
|
93
|
+
* Инстанс и MCP-реестр (read-only, Workstream A1): тулы `synth_info`,
|
|
94
|
+
* `synth_mcp_list`, `synth_mcp_test`.
|
|
95
|
+
*
|
|
96
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/
|
|
97
|
+
* `process`/`models`: инстанс и его MCP-реестр — доменный ресурс, а не
|
|
98
|
+
* примитив ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
99
|
+
* (`WORKSPACE_CAPABILITIES`) — сведения об инстансе доступны и без workspace.
|
|
100
|
+
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
101
|
+
*/
|
|
102
|
+
INSTANCE: 'instance',
|
|
67
103
|
};
|
|
68
104
|
export const TOOL_CAPABILITY_META = {
|
|
69
105
|
[ToolCapability.FILE_READ]: { label: 'Чтение файлов', description: 'read_file, list_directory, glob' },
|
|
@@ -92,10 +128,22 @@ export const TOOL_CAPABILITY_META = {
|
|
|
92
128
|
},
|
|
93
129
|
[ToolCapability.PROCESS]: {
|
|
94
130
|
label: 'Фоновые процессы',
|
|
95
|
-
description: 'process_list, process_logs',
|
|
131
|
+
description: 'process_list, process_logs, process_stop, process_delete',
|
|
96
132
|
},
|
|
97
133
|
[ToolCapability.MODELS]: {
|
|
98
134
|
label: 'Модели',
|
|
99
135
|
description: 'list_models',
|
|
100
136
|
},
|
|
137
|
+
[ToolCapability.SSH]: {
|
|
138
|
+
label: 'Удалённый SSH',
|
|
139
|
+
description: 'ssh_exec',
|
|
140
|
+
},
|
|
141
|
+
[ToolCapability.TODO]: {
|
|
142
|
+
label: 'Список задач сессии',
|
|
143
|
+
description: 'todo_write, todo_list, todo_add, todo_update, todo_delete',
|
|
144
|
+
},
|
|
145
|
+
[ToolCapability.INSTANCE]: {
|
|
146
|
+
label: 'Инстанс и MCP',
|
|
147
|
+
description: 'synth_info, synth_mcp_list, synth_mcp_test',
|
|
148
|
+
},
|
|
101
149
|
};
|
package/dist/types/user.d.ts
CHANGED
|
@@ -26,6 +26,13 @@ export interface TestUser {
|
|
|
26
26
|
export interface AuthConfig {
|
|
27
27
|
debugMode: boolean;
|
|
28
28
|
apiKey?: string;
|
|
29
|
+
/**
|
|
30
|
+
* Роли, выдаваемые пользователю единого API-ключа (`auth.apiKey` /
|
|
31
|
+
* `SYNTH_API_KEY`) вне debug/OIDC. По умолчанию `['USER']` — права ADMIN
|
|
32
|
+
* выдаются только **явной** настройкой (`auth.apiKeyRoles` /
|
|
33
|
+
* `SYNTH_API_KEY_ROLES`), а не по факту наличия ключа.
|
|
34
|
+
*/
|
|
35
|
+
apiKeyRoles?: GlobalRole[];
|
|
29
36
|
testUsers?: TestUser[];
|
|
30
37
|
sessionMaxAgeMinutes: number;
|
|
31
38
|
oidc?: {
|
package/dist/types/worktree.d.ts
CHANGED
|
@@ -103,7 +103,7 @@ export interface SessionWorktree {
|
|
|
103
103
|
branch: string;
|
|
104
104
|
}
|
|
105
105
|
/**
|
|
106
|
-
* Что именно изменилось в инвентаре worktree
|
|
106
|
+
* Что именно изменилось в инвентаре worktree (ADR-114 §6) — значение
|
|
107
107
|
* `action` события `worktree.updated`.
|
|
108
108
|
*
|
|
109
109
|
* - `created` — создана запись (каталог + ветка);
|
package/dist/utils/index.js
CHANGED
|
@@ -39,7 +39,7 @@ export async function atomicWrite(writeFile, rename, targetPath, data) {
|
|
|
39
39
|
* строка возвращается, если NUL-байтов нет.
|
|
40
40
|
*/
|
|
41
41
|
export function stripNullBytes(value) {
|
|
42
|
-
return value.includes('\u0000') ? value.
|
|
42
|
+
return value.includes('\u0000') ? value.replaceAll('\u0000', '') : value;
|
|
43
43
|
}
|
|
44
44
|
/** Обычный объект-литерал (`{}` или `Object.create(null)`), не класс/Date/Buffer. */
|
|
45
45
|
function isPlainObjectValue(value) {
|
|
@@ -1,7 +1,19 @@
|
|
|
1
|
-
/**
|
|
1
|
+
/**
|
|
2
|
+
* Блок рассуждений: текст и итерация Tool Use, к которой он относится.
|
|
3
|
+
* `signature`/`redacted` — служебные данные Anthropic-протокола: подпись
|
|
4
|
+
* thinking-блока и opaque-данные `redacted_thinking` (аддитивные поля,
|
|
5
|
+
* остальные провайдеры их не заполняют).
|
|
6
|
+
*/
|
|
2
7
|
export interface ReasoningBlock {
|
|
3
8
|
text: string;
|
|
4
9
|
iteration: number;
|
|
10
|
+
signature?: string;
|
|
11
|
+
redacted?: string;
|
|
12
|
+
}
|
|
13
|
+
/** Служебная подпись блока (передаётся в `appendReasoningBlock`). */
|
|
14
|
+
export interface ReasoningBlockMeta {
|
|
15
|
+
signature?: string;
|
|
16
|
+
redacted?: string;
|
|
5
17
|
}
|
|
6
18
|
/**
|
|
7
19
|
* Накопить блок рассуждений: текст от провайдера кумулятивный, поэтому
|
|
@@ -11,6 +23,10 @@ export interface ReasoningBlock {
|
|
|
11
23
|
* проверяется раньше дедупа — иначе каждый следующий кумулятивный чанк давал бы
|
|
12
24
|
* новый блок, а рестарт попытки (текст снова с нуля) — блок-дубль.
|
|
13
25
|
*
|
|
26
|
+
* Блок без текста, но с подписью/redacted (`signature: ""`, `redacted_thinking`)
|
|
27
|
+
* — валидный и добавляется отдельным элементом: подпись принадлежит своему
|
|
28
|
+
* блоку, терять её нельзя.
|
|
29
|
+
*
|
|
14
30
|
* Вход не мутируется: изменённые ветки возвращают новый массив.
|
|
15
31
|
*/
|
|
16
|
-
export declare function appendReasoningBlock(blocks: readonly ReasoningBlock[], text: string, iteration: number): ReasoningBlock[];
|
|
32
|
+
export declare function appendReasoningBlock(blocks: readonly ReasoningBlock[], text: string, iteration: number, meta?: ReasoningBlockMeta): ReasoningBlock[];
|
package/dist/utils/reasoning.js
CHANGED
|
@@ -7,15 +7,24 @@
|
|
|
7
7
|
* проверяется раньше дедупа — иначе каждый следующий кумулятивный чанк давал бы
|
|
8
8
|
* новый блок, а рестарт попытки (текст снова с нуля) — блок-дубль.
|
|
9
9
|
*
|
|
10
|
+
* Блок без текста, но с подписью/redacted (`signature: ""`, `redacted_thinking`)
|
|
11
|
+
* — валидный и добавляется отдельным элементом: подпись принадлежит своему
|
|
12
|
+
* блоку, терять её нельзя.
|
|
13
|
+
*
|
|
10
14
|
* Вход не мутируется: изменённые ветки возвращают новый массив.
|
|
11
15
|
*/
|
|
12
|
-
export function appendReasoningBlock(blocks, text, iteration) {
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
+
export function appendReasoningBlock(blocks, text, iteration, meta) {
|
|
17
|
+
const hasMeta = meta !== undefined
|
|
18
|
+
&& (meta.signature !== undefined || meta.redacted !== undefined);
|
|
19
|
+
// 1. Пустой/пробельный текст без метаданных состояния не меняет.
|
|
20
|
+
if (!text || !text.trim()) {
|
|
21
|
+
if (!hasMeta)
|
|
22
|
+
return [...blocks];
|
|
23
|
+
return [...blocks, { text: text ?? '', iteration, ...meta }];
|
|
24
|
+
}
|
|
16
25
|
// 2. Первый блок.
|
|
17
26
|
if (blocks.length === 0)
|
|
18
|
-
return [{ text, iteration }];
|
|
27
|
+
return [{ text, iteration, ...meta }];
|
|
19
28
|
const last = blocks[blocks.length - 1];
|
|
20
29
|
// 3. Тот же текст — ничего не меняем.
|
|
21
30
|
if (text === last.text)
|
|
@@ -23,7 +32,7 @@ export function appendReasoningBlock(blocks, text, iteration) {
|
|
|
23
32
|
// 4. Продолжение того же рассуждения (в т.ч. при смене итерации) — заменяем
|
|
24
33
|
// последний блок, а не добавляем новый.
|
|
25
34
|
if (text.startsWith(last.text)) {
|
|
26
|
-
return [...blocks.slice(0, -1), { text, iteration }];
|
|
35
|
+
return [...blocks.slice(0, -1), { text, iteration, ...meta }];
|
|
27
36
|
}
|
|
28
37
|
// 5. Пришёл более короткий вариант — рестарт/повтор той же попытки, состояние
|
|
29
38
|
// уже содержит более полный текст.
|
|
@@ -33,5 +42,5 @@ export function appendReasoningBlock(blocks, text, iteration) {
|
|
|
33
42
|
if (blocks.some((block) => block.text === text))
|
|
34
43
|
return [...blocks];
|
|
35
44
|
// 7. Новое рассуждение.
|
|
36
|
-
return [...blocks, { text, iteration }];
|
|
45
|
+
return [...blocks, { text, iteration, ...meta }];
|
|
37
46
|
}
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const SYNTH_VERSION = "0.
|
|
1
|
+
export declare const SYNTH_VERSION = "0.13.8";
|
package/dist/version.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const SYNTH_VERSION = '0.
|
|
1
|
+
export const SYNTH_VERSION = '0.13.8';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-shared",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.8",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
}
|
|
48
48
|
},
|
|
49
49
|
"dependencies": {
|
|
50
|
-
"js-yaml": "^4.
|
|
50
|
+
"js-yaml": "^4.3.2",
|
|
51
51
|
"zod": "^4.6.7"
|
|
52
52
|
},
|
|
53
53
|
"devDependencies": {
|
|
@@ -60,6 +60,7 @@
|
|
|
60
60
|
"typecheck": "tsc --noEmit",
|
|
61
61
|
"test": "vitest run",
|
|
62
62
|
"test:watch": "vitest",
|
|
63
|
-
"clean": "rm -rf dist"
|
|
63
|
+
"clean": "rm -rf dist",
|
|
64
|
+
"lint": "eslint src/ --max-warnings 1"
|
|
64
65
|
}
|
|
65
66
|
}
|