@itphx/synth-shared 0.10.1 → 0.12.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 (104) hide show
  1. package/dist/config/defaults.js +172 -3
  2. package/dist/config/env-overrides.d.ts +33 -1
  3. package/dist/config/env-overrides.js +191 -5
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +4 -0
  7. package/dist/config/index.js +4 -0
  8. package/dist/config/loader.js +19 -0
  9. package/dist/config/proxy.d.ts +415 -0
  10. package/dist/config/proxy.js +1567 -0
  11. package/dist/config/resolve.d.ts +67 -0
  12. package/dist/config/resolve.js +187 -1
  13. package/dist/config/tls-runtime.d.ts +78 -0
  14. package/dist/config/tls-runtime.js +356 -0
  15. package/dist/config/tls.d.ts +215 -0
  16. package/dist/config/tls.js +394 -0
  17. package/dist/config/types.d.ts +1571 -2835
  18. package/dist/config/types.js +717 -58
  19. package/dist/i18n/index.d.ts +1 -1
  20. package/dist/i18n/index.js +279 -0
  21. package/dist/index.d.ts +24 -3
  22. package/dist/index.js +25 -2
  23. package/dist/model-metadata.d.ts +10 -0
  24. package/dist/protocols/index.d.ts +0 -1
  25. package/dist/schemas/index.d.ts +1014 -2231
  26. package/dist/schemas/index.js +222 -14
  27. package/dist/types/analytics.d.ts +113 -0
  28. package/dist/types/analytics.js +61 -0
  29. package/dist/types/authority.d.ts +464 -0
  30. package/dist/types/authority.js +445 -0
  31. package/dist/types/background.d.ts +96 -0
  32. package/dist/types/background.js +24 -0
  33. package/dist/types/bus-events.d.ts +23 -1
  34. package/dist/types/catalog.d.ts +349 -0
  35. package/dist/types/catalog.js +393 -0
  36. package/dist/types/decision.d.ts +28 -337
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +54 -2
  40. package/dist/types/external-credentials.d.ts +352 -0
  41. package/dist/types/external-credentials.js +200 -0
  42. package/dist/types/fs.d.ts +11 -0
  43. package/dist/types/fs.js +11 -0
  44. package/dist/types/hooks.d.ts +50 -9
  45. package/dist/types/index.d.ts +23 -0
  46. package/dist/types/index.js +55 -0
  47. package/dist/types/llm-filters.d.ts +150 -0
  48. package/dist/types/llm-filters.js +54 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +101 -5
  52. package/dist/types/mcp.js +127 -5
  53. package/dist/types/message.d.ts +45 -1
  54. package/dist/types/pack.d.ts +1102 -0
  55. package/dist/types/pack.js +1003 -0
  56. package/dist/types/permission.d.ts +31 -15
  57. package/dist/types/permission.js +1 -1
  58. package/dist/types/pipeline-engine.d.ts +453 -0
  59. package/dist/types/pipeline-engine.js +440 -0
  60. package/dist/types/pipeline.d.ts +275 -0
  61. package/dist/types/pipeline.js +212 -0
  62. package/dist/types/plugin-audit.d.ts +110 -0
  63. package/dist/types/plugin-audit.js +185 -0
  64. package/dist/types/plugin-hybrid.d.ts +85 -0
  65. package/dist/types/plugin-hybrid.js +68 -0
  66. package/dist/types/plugin-lock.d.ts +95 -0
  67. package/dist/types/plugin-lock.js +1 -0
  68. package/dist/types/plugin-protocol.d.ts +221 -0
  69. package/dist/types/plugin-protocol.js +322 -0
  70. package/dist/types/plugin-runtime.d.ts +25 -0
  71. package/dist/types/plugin-runtime.js +11 -0
  72. package/dist/types/plugin-scan.d.ts +159 -0
  73. package/dist/types/plugin-scan.js +166 -0
  74. package/dist/types/plugin-tools.d.ts +51 -0
  75. package/dist/types/plugin-tools.js +72 -0
  76. package/dist/types/project.d.ts +14 -0
  77. package/dist/types/prompt-blocks.d.ts +102 -0
  78. package/dist/types/prompt-blocks.js +24 -0
  79. package/dist/types/prompt.d.ts +47 -4
  80. package/dist/types/provider.d.ts +11 -0
  81. package/dist/types/question.d.ts +153 -0
  82. package/dist/types/question.js +65 -0
  83. package/dist/types/schedules.d.ts +26 -3
  84. package/dist/types/semver.d.ts +48 -0
  85. package/dist/types/semver.js +218 -0
  86. package/dist/types/service-keys.d.ts +41 -3
  87. package/dist/types/service-keys.js +44 -2
  88. package/dist/types/session.d.ts +54 -1
  89. package/dist/types/steering.d.ts +74 -0
  90. package/dist/types/steering.js +75 -0
  91. package/dist/types/tools.d.ts +125 -5
  92. package/dist/types/tools.js +75 -0
  93. package/dist/types/trust.d.ts +31 -0
  94. package/dist/types/trust.js +27 -0
  95. package/dist/types/webhooks.d.ts +1 -1
  96. package/dist/types/worktree.d.ts +170 -0
  97. package/dist/types/worktree.js +101 -0
  98. package/dist/utils/index.d.ts +46 -1
  99. package/dist/utils/index.js +145 -12
  100. package/dist/utils/reasoning.d.ts +16 -0
  101. package/dist/utils/reasoning.js +37 -0
  102. package/dist/version.d.ts +1 -1
  103. package/dist/version.js +1 -1
  104. package/package.json +2 -2
@@ -0,0 +1,170 @@
1
+ /**
2
+ * Контракт «git worktree» — per-session рабочий каталог (ADR-114, этап 1
3
+ * roadmap 0.13 — блок 1.4.1a; спека подсистемы — `docs/WORKTREES.md` §1–§2).
4
+ *
5
+ * Worktree — вторичная рабочая копия репозитория: у каждой сессии может быть
6
+ * свой каталог, чтобы правки соседних сессий не конфликтовали по рабочим
7
+ * файлам и индексу (ADR-114).
8
+ *
9
+ * Здесь только контракты (тип записи + Zod-схемы HTTP-входа) — без
10
+ * бизнес-логики: создание каталога (`git worktree add`), привязка сессии и
11
+ * резолв рабочего каталога живут в core (следующий шаг).
12
+ */
13
+ import { z } from 'zod';
14
+ /**
15
+ * Стратегия записи worktree. Сейчас одна — `git` (ADR-114 §5: тулы
16
+ * `git_worktree_*` работают через слой git, ADR-076/ADR-077).
17
+ */
18
+ export type WorktreeStrategy = 'git';
19
+ /** Канонический набор стратегий worktree. */
20
+ export declare const WORKTREE_STRATEGIES: readonly WorktreeStrategy[];
21
+ /**
22
+ * Запись worktree (`wkt_<uuid>`) — запись инвентаря проекта (ADR-114 §1.1).
23
+ *
24
+ * Запись переживает рестарт сервиса: её держит доменный порт
25
+ * `WorktreeRepository` (ADR-096), физически — `{dataDir}/worktrees.json`
26
+ * (файловый backend) либо generic-таблица `documents` (`kind='worktree'`,
27
+ * PostgreSQL-драйвер).
28
+ */
29
+ export interface WorktreeRecord {
30
+ /** `wkt_<uuid>`, уникален в пределах инстанса. */
31
+ id: string;
32
+ /** Проект-владелец записи (обязателен). */
33
+ projectId: string;
34
+ /**
35
+ * Репозиторий проекта относительно `project.workspace` (как `repo_path`
36
+ * в ADR-076); отсутствует — репозиторий в корне workspace.
37
+ */
38
+ repoPath?: string;
39
+ /** Абсолютный путь каталога worktree на диске. */
40
+ directory: string;
41
+ /** Ветка (`HEAD` — detached-состояние). */
42
+ branch: string;
43
+ /**
44
+ * Человекочитаемое имя каталога (slug) внутри `.worktrees/<projectId>/`:
45
+ * уникально в пределах проекта, формат — `WORKTREE_NAME_REGEX`.
46
+ */
47
+ name: string;
48
+ /** Стратегия записи (сейчас только `git`). */
49
+ strategy: WorktreeStrategy;
50
+ /** Момент создания записи (ISO-8601) — иммутабельно. */
51
+ createdAt: string;
52
+ /** Момент последнего изменения (ISO-8601) — ставит вызывающий (порт «сейчас» не подставляет). */
53
+ updatedAt: string;
54
+ /** Пользователь, создавший запись (аудит, не авторизация). */
55
+ createdBy?: string;
56
+ }
57
+ /**
58
+ * Тело создания worktree (HTTP-вход).
59
+ *
60
+ * Все поля необязательные: сервис подставляет дефолты (имя каталога из
61
+ * ветки, ветку — из базовой ветки репозитория). `from` — база ветки при
62
+ * создании (`main`/`master`/SHA).
63
+ */
64
+ export interface WorktreeCreateInput {
65
+ /** Ветка worktree. */
66
+ branch?: string;
67
+ /** Человекочитаемое имя каталога (slug). */
68
+ name?: string;
69
+ /** Репозиторий относительно `project.workspace` (пусто/нет — корень workspace). */
70
+ repoPath?: string;
71
+ /** База ветки при создании (`main`/`master`/SHA). */
72
+ from?: string;
73
+ }
74
+ /**
75
+ * Сводка записи для API: сама запись + вычисляемые сервисом поля.
76
+ *
77
+ * Вычисляемые поля **в порт не пишутся** — их считает сервис (наличие
78
+ * каталога на диске, «грязное» состояние, привязанная сессия).
79
+ */
80
+ export interface WorktreeSummary extends WorktreeRecord {
81
+ /** Сессия, привязанная к worktree (если есть). */
82
+ attachedSessionId?: string;
83
+ /** Есть ли незакоммиченные изменения в каталоге. */
84
+ dirty?: boolean;
85
+ /** Существует ли каталог worktree на диске. */
86
+ exists?: boolean;
87
+ }
88
+ /**
89
+ * Привязка сессии к worktree (ADR-114 §1.3) — **снимок** на момент привязки:
90
+ * `directory`/`branch` копируются из записи, чтобы резолв рабочего каталога не
91
+ * требовал чтения порта на каждом ходу.
92
+ */
93
+ export interface SessionWorktree {
94
+ /** Идентификатор записи worktree. */
95
+ worktreeId: string;
96
+ /** Проект-владелец worktree. */
97
+ projectId: string;
98
+ /** Репозиторий относительно `project.workspace` (если не корень workspace). */
99
+ repoPath?: string;
100
+ /** Абсолютный путь каталога worktree. */
101
+ directory: string;
102
+ /** Ветка на момент привязки. */
103
+ branch: string;
104
+ }
105
+ /**
106
+ * Что именно изменилось в инвентаре worktree'ов (ADR-114 §6) — значение
107
+ * `action` события `worktree.updated`.
108
+ *
109
+ * - `created` — создана запись (каталог + ветка);
110
+ * - `removed` — запись удалена (каталог снят);
111
+ * - `pruned` — вычищены записи без каталога (prune/sweep);
112
+ * - `attached` — запись привязана к сессии;
113
+ * - `detached` — привязка снята (в т.ч. при переносе сессии в другой проект).
114
+ */
115
+ export type WorktreeUpdateAction = 'created' | 'removed' | 'pruned' | 'attached' | 'detached';
116
+ /** Канонический набор действий `worktree.updated`. */
117
+ export declare const WORKTREE_UPDATE_ACTIONS: readonly WorktreeUpdateAction[];
118
+ /** Формат slug'а имени каталога worktree: строчные буквы/цифры, `-_.` внутри. */
119
+ export declare const WORKTREE_NAME_REGEX: RegExp;
120
+ /** Предельная длина имени каталога worktree. */
121
+ export declare const WORKTREE_NAME_MAX_LENGTH = 64;
122
+ /**
123
+ * Допустимо ли имя ветки: непустое, без пробелов, без `..` и без
124
+ * запрещённых символов (`~`, `^`, `:`, `?`, `*`, `[`, `\`).
125
+ */
126
+ export declare function isValidWorktreeBranch(branch: string): boolean;
127
+ /**
128
+ * Допустим ли путь репозитория: относительный (без корня и без диска
129
+ * Windows) и без сегмента `..` — как `repo_path` в ADR-076.
130
+ */
131
+ export declare function isValidWorktreeRepoPath(repoPath: string): boolean;
132
+ /** Полная запись worktree (ответы API). */
133
+ export declare const worktreeRecordSchema: z.ZodObject<{
134
+ id: z.ZodString;
135
+ projectId: z.ZodString;
136
+ repoPath: z.ZodOptional<z.ZodString>;
137
+ directory: z.ZodString;
138
+ branch: z.ZodString;
139
+ name: z.ZodString;
140
+ strategy: z.ZodEnum<{
141
+ git: "git";
142
+ }>;
143
+ createdAt: z.ZodString;
144
+ updatedAt: z.ZodString;
145
+ createdBy: z.ZodOptional<z.ZodString>;
146
+ }, z.core.$strip>;
147
+ /**
148
+ * Тело создания worktree (`POST /api/v2/projects/:id/worktrees`).
149
+ *
150
+ * Валидация: `name` — slug (`WORKTREE_NAME_REGEX`), `branch` — без пробелов,
151
+ * `..` и запрещённых символов, `repoPath` — относительный путь без `..`.
152
+ */
153
+ export declare const worktreeCreateSchema: z.ZodObject<{
154
+ branch: z.ZodOptional<z.ZodString>;
155
+ name: z.ZodOptional<z.ZodString>;
156
+ repoPath: z.ZodOptional<z.ZodString>;
157
+ from: z.ZodOptional<z.ZodString>;
158
+ }, z.core.$strip>;
159
+ /**
160
+ * Тело операции prune (`POST /api/v2/projects/:id/worktrees/prune`).
161
+ *
162
+ * Параметров у операции нет: проект берётся из пути, чистятся записи без
163
+ * каталога (ADR-114 §7.3). Схема — строгая: лишние поля — ошибка валидации,
164
+ * а не молчаливое игнорирование.
165
+ */
166
+ export declare const worktreePruneSchema: z.ZodObject<{}, z.core.$strict>;
167
+ /** Форма входа тела создания worktree. */
168
+ export type WorktreeCreateRequest = z.input<typeof worktreeCreateSchema>;
169
+ /** Форма входа тела prune. */
170
+ export type WorktreePruneRequest = z.input<typeof worktreePruneSchema>;
@@ -0,0 +1,101 @@
1
+ /**
2
+ * Контракт «git worktree» — per-session рабочий каталог (ADR-114, этап 1
3
+ * roadmap 0.13 — блок 1.4.1a; спека подсистемы — `docs/WORKTREES.md` §1–§2).
4
+ *
5
+ * Worktree — вторичная рабочая копия репозитория: у каждой сессии может быть
6
+ * свой каталог, чтобы правки соседних сессий не конфликтовали по рабочим
7
+ * файлам и индексу (ADR-114).
8
+ *
9
+ * Здесь только контракты (тип записи + Zod-схемы HTTP-входа) — без
10
+ * бизнес-логики: создание каталога (`git worktree add`), привязка сессии и
11
+ * резолв рабочего каталога живут в core (следующий шаг).
12
+ */
13
+ import { z } from 'zod';
14
+ /** Канонический набор стратегий worktree. */
15
+ export const WORKTREE_STRATEGIES = ['git'];
16
+ /** Канонический набор действий `worktree.updated`. */
17
+ export const WORKTREE_UPDATE_ACTIONS = [
18
+ 'created',
19
+ 'removed',
20
+ 'pruned',
21
+ 'attached',
22
+ 'detached',
23
+ ];
24
+ // ── Zod-схемы (HTTP-вход и запись) ─────────────────────────────────────────────
25
+ /** Формат slug'а имени каталога worktree: строчные буквы/цифры, `-_.` внутри. */
26
+ export const WORKTREE_NAME_REGEX = /^[a-z0-9][a-z0-9._-]{0,63}$/;
27
+ /** Предельная длина имени каталога worktree. */
28
+ export const WORKTREE_NAME_MAX_LENGTH = 64;
29
+ /** Символы, запрещённые в имени ветки (набор — как в `git check-ref-format`). */
30
+ const FORBIDDEN_BRANCH_CHARS = ['~', '^', ':', '?', '*', '[', '\\'];
31
+ /**
32
+ * Допустимо ли имя ветки: непустое, без пробелов, без `..` и без
33
+ * запрещённых символов (`~`, `^`, `:`, `?`, `*`, `[`, `\`).
34
+ */
35
+ export function isValidWorktreeBranch(branch) {
36
+ if (branch.length === 0)
37
+ return false;
38
+ if (/\s/.test(branch))
39
+ return false;
40
+ if (branch.includes('..'))
41
+ return false;
42
+ return !FORBIDDEN_BRANCH_CHARS.some((char) => branch.includes(char));
43
+ }
44
+ /**
45
+ * Допустим ли путь репозитория: относительный (без корня и без диска
46
+ * Windows) и без сегмента `..` — как `repo_path` в ADR-076.
47
+ */
48
+ export function isValidWorktreeRepoPath(repoPath) {
49
+ if (repoPath.trim().length === 0)
50
+ return false;
51
+ if (repoPath.startsWith('/') || repoPath.startsWith('\\'))
52
+ return false;
53
+ if (/^[a-zA-Z]:[\\/]/.test(repoPath))
54
+ return false;
55
+ return !repoPath.split(/[\\/]+/).includes('..');
56
+ }
57
+ /** Полная запись worktree (ответы API). */
58
+ export const worktreeRecordSchema = z.object({
59
+ id: z.string().min(1),
60
+ projectId: z.string().min(1),
61
+ repoPath: z.string().min(1).optional(),
62
+ directory: z.string().min(1),
63
+ branch: z.string().min(1),
64
+ name: z.string().regex(WORKTREE_NAME_REGEX),
65
+ strategy: z.enum(['git']),
66
+ createdAt: z.string().min(1),
67
+ updatedAt: z.string().min(1),
68
+ createdBy: z.string().min(1).optional(),
69
+ });
70
+ /**
71
+ * Тело создания worktree (`POST /api/v2/projects/:id/worktrees`).
72
+ *
73
+ * Валидация: `name` — slug (`WORKTREE_NAME_REGEX`), `branch` — без пробелов,
74
+ * `..` и запрещённых символов, `repoPath` — относительный путь без `..`.
75
+ */
76
+ export const worktreeCreateSchema = z.object({
77
+ branch: z
78
+ .string()
79
+ .min(1)
80
+ .refine(isValidWorktreeBranch, {
81
+ message: 'Имя ветки недопустимо: без пробелов, «..», «~», «^», «:», «?», «*», «[», «\\»',
82
+ })
83
+ .optional(),
84
+ name: z.string().regex(WORKTREE_NAME_REGEX).optional(),
85
+ repoPath: z
86
+ .string()
87
+ .min(1)
88
+ .refine(isValidWorktreeRepoPath, {
89
+ message: 'Путь репозитория должен быть относительным и без «..»',
90
+ })
91
+ .optional(),
92
+ from: z.string().min(1).optional(),
93
+ });
94
+ /**
95
+ * Тело операции prune (`POST /api/v2/projects/:id/worktrees/prune`).
96
+ *
97
+ * Параметров у операции нет: проект берётся из пути, чистятся записи без
98
+ * каталога (ADR-114 §7.3). Схема — строгая: лишние поля — ошибка валидации,
99
+ * а не молчаливое игнорирование.
100
+ */
101
+ export const worktreePruneSchema = z.object({}).strict();
@@ -4,6 +4,21 @@ export declare function formatISODate(date: Date): string;
4
4
  export declare function nowISO(): string;
5
5
  export declare function safeJsonParse<T>(data: string, fallback: T): T;
6
6
  export declare function atomicWrite(writeFile: (path: string, data: string) => Promise<void>, rename: (oldPath: string, newPath: string) => Promise<void>, targetPath: string, data: string): Promise<void>;
7
+ /**
8
+ * Удаляет NUL-символы (`\u0000`) из строки. PostgreSQL не принимает U+0000
9
+ * ни в `text` («invalid byte sequence for encoding "UTF8": 0x00»), ни в `jsonb`
10
+ * (`JSON.stringify` даёт escape `\u0000` → «unsupported Unicode escape
11
+ * sequence»), поэтому недоверенный текст (ответ модели, вывод тулов/файлов/
12
+ * shell/веба) чистится до записи. Остальные символы не меняются; исходная
13
+ * строка возвращается, если NUL-байтов нет.
14
+ */
15
+ export declare function stripNullBytes(value: string): string;
16
+ /**
17
+ * Рекурсивно удаляет NUL-байты из строк в массивах/plain-объектах.
18
+ * `Date`, `Buffer` и прочие non-plain объекты возвращаются как есть.
19
+ * Если изменений нет — возвращается исходное значение (та же ссылка).
20
+ */
21
+ export declare function stripNullBytesDeep<T>(value: T): T;
7
22
  export declare class AsyncLock {
8
23
  private _locked;
9
24
  private _waiting;
@@ -15,10 +30,40 @@ export declare function isDefaultTitle(title?: string): boolean;
15
30
  export declare function getForkedTitle(title?: string, existingTitles?: string[]): string;
16
31
  export { globMatch } from './glob.js';
17
32
  export { slugifyWorkspaceName, uniqueWorkspaceName, MAX_WORKSPACE_SLUG_LENGTH } from './workspace.js';
18
- import type { Part, PartType } from '../types/index.js';
33
+ export { appendReasoningBlock, type ReasoningBlock } from './reasoning.js';
34
+ import type { MediaPartData, MediaPartType, Part, PartType } from '../types/index.js';
19
35
  import type { ProfileStore } from '../interfaces/index.js';
20
36
  export declare function makePart(type: PartType, data: unknown): Part;
21
37
  export declare function makeTextPart(text: string): Part;
38
+ /**
39
+ * ADR-115: медиа-часть вложения (ссылка на blob + метаданные).
40
+ */
41
+ export declare function makeMediaPart(type: MediaPartType, data: MediaPartData): Part;
42
+ /**
43
+ * ADR-115: плейсхолдер медиа-части для строковых производных (`content`).
44
+ *
45
+ * Вложение обязано оставить след в тексте: иначе факт вложения «испаряется»
46
+ * без ошибки (экспорт, поиск, PG-маппинг `messages.content`). Формат —
47
+ * `[<type>: <name>]`, без имени — `[<type>]`.
48
+ */
49
+ export declare function mediaPartPlaceholder(type: MediaPartType, data: unknown): string;
50
+ /**
51
+ * ADR-115: тип медиа-части по MIME.
52
+ *
53
+ * Совпадает с `partTypeOf` ядра (`engine/attachments/service.ts`) — композеру
54
+ * нужен тот же маппинг, чтобы маркер в тексте совпал с серверным.
55
+ */
56
+ export declare function mediaTypeOfMime(mime: string): MediaPartType;
57
+ /**
58
+ * ADR-115: дописать в текст отсутствующие плейсхолдеры медиа-частей.
59
+ *
60
+ * Сервер строит `content` из частей, но маркер может прийти уже из композера
61
+ * (пользователь набрал его сам или он был вставлен при прикреплении). Поэтому
62
+ * добавляются только те плейсхолдеры, которых в тексте ещё нет — иначе один
63
+ * файл дал бы два вхождения. Не-медиа части игнорируются; пустой текст не
64
+ * получает ведущего перевода строки.
65
+ */
66
+ export declare function appendMediaPlaceholders(text: string, parts: Part[]): string;
22
67
  export declare function buildContentFromParts(parts: Part[]): string;
23
68
  /** Favicon по origin базового URL провайдера; undefined — URL некорректен/пуст. */
24
69
  export declare function getFaviconUrl(baseUrl?: string): string | undefined;
@@ -29,6 +29,59 @@ export async function atomicWrite(writeFile, rename, targetPath, data) {
29
29
  await writeFile(tmpPath, data);
30
30
  await rename(tmpPath, targetPath);
31
31
  }
32
+ // Санитизация недоверенного текста (U+0000)
33
+ /**
34
+ * Удаляет NUL-символы (`\u0000`) из строки. PostgreSQL не принимает U+0000
35
+ * ни в `text` («invalid byte sequence for encoding "UTF8": 0x00»), ни в `jsonb`
36
+ * (`JSON.stringify` даёт escape `\u0000` → «unsupported Unicode escape
37
+ * sequence»), поэтому недоверенный текст (ответ модели, вывод тулов/файлов/
38
+ * shell/веба) чистится до записи. Остальные символы не меняются; исходная
39
+ * строка возвращается, если NUL-байтов нет.
40
+ */
41
+ export function stripNullBytes(value) {
42
+ return value.includes('\u0000') ? value.replace(/\u0000/g, '') : value;
43
+ }
44
+ /** Обычный объект-литерал (`{}` или `Object.create(null)`), не класс/Date/Buffer. */
45
+ function isPlainObjectValue(value) {
46
+ const proto = Object.getPrototypeOf(value);
47
+ return proto === Object.prototype || proto === null;
48
+ }
49
+ function stripNullBytesDeepInternal(value) {
50
+ if (typeof value === 'string')
51
+ return stripNullBytes(value);
52
+ if (Array.isArray(value)) {
53
+ let changed = false;
54
+ const result = value.map((item) => {
55
+ const next = stripNullBytesDeepInternal(item);
56
+ if (next !== item)
57
+ changed = true;
58
+ return next;
59
+ });
60
+ return changed ? result : value;
61
+ }
62
+ // Date/Buffer/классы/Map/Set и прочие non-plain объекты не трогаем:
63
+ // их содержимое не является текстом домена.
64
+ if (typeof value === 'object' && value !== null && isPlainObjectValue(value)) {
65
+ let changed = false;
66
+ const result = Object.create(Object.getPrototypeOf(value));
67
+ for (const [key, item] of Object.entries(value)) {
68
+ const next = stripNullBytesDeepInternal(item);
69
+ if (next !== item)
70
+ changed = true;
71
+ result[key] = next;
72
+ }
73
+ return changed ? result : value;
74
+ }
75
+ return value;
76
+ }
77
+ /**
78
+ * Рекурсивно удаляет NUL-байты из строк в массивах/plain-объектах.
79
+ * `Date`, `Buffer` и прочие non-plain объекты возвращаются как есть.
80
+ * Если изменений нет — возвращается исходное значение (та же ссылка).
81
+ */
82
+ export function stripNullBytesDeep(value) {
83
+ return stripNullBytesDeepInternal(value);
84
+ }
32
85
  // Асинхронный Mutex
33
86
  export class AsyncLock {
34
87
  _locked = false;
@@ -94,36 +147,116 @@ export function getForkedTitle(title, existingTitles) {
94
147
  export { globMatch } from './glob.js';
95
148
  // --- Workspace (ADR-075) ---
96
149
  export { slugifyWorkspaceName, uniqueWorkspaceName, MAX_WORKSPACE_SLUG_LENGTH } from './workspace.js';
150
+ // --- Блоки рассуждений модели (общий хелпер UI и ядра) ---
151
+ export { appendReasoningBlock } from './reasoning.js';
97
152
  export function makePart(type, data) {
98
153
  return { id: generateId(), type, data };
99
154
  }
100
155
  export function makeTextPart(text) {
101
156
  return makePart('text', text);
102
157
  }
158
+ /**
159
+ * ADR-115: медиа-часть вложения (ссылка на blob + метаданные).
160
+ */
161
+ export function makeMediaPart(type, data) {
162
+ return makePart(type, data);
163
+ }
164
+ /**
165
+ * ADR-115: плейсхолдер медиа-части для строковых производных (`content`).
166
+ *
167
+ * Вложение обязано оставить след в тексте: иначе факт вложения «испаряется»
168
+ * без ошибки (экспорт, поиск, PG-маппинг `messages.content`). Формат —
169
+ * `[<type>: <name>]`, без имени — `[<type>]`.
170
+ */
171
+ export function mediaPartPlaceholder(type, data) {
172
+ const name = typeof data === 'object' && data !== null
173
+ ? data.name
174
+ : undefined;
175
+ const label = typeof name === 'string' && name.trim() !== '' ? name.trim() : undefined;
176
+ return label ? `[${type}: ${label}]` : `[${type}]`;
177
+ }
178
+ /**
179
+ * ADR-115: тип медиа-части по MIME.
180
+ *
181
+ * Совпадает с `partTypeOf` ядра (`engine/attachments/service.ts`) — композеру
182
+ * нужен тот же маппинг, чтобы маркер в тексте совпал с серверным.
183
+ */
184
+ export function mediaTypeOfMime(mime) {
185
+ const normalized = mime.trim().toLowerCase();
186
+ if (normalized.startsWith('image/'))
187
+ return 'image';
188
+ if (normalized.startsWith('audio/'))
189
+ return 'audio';
190
+ if (normalized.startsWith('video/'))
191
+ return 'video';
192
+ return 'file';
193
+ }
194
+ /**
195
+ * ADR-115: дописать в текст отсутствующие плейсхолдеры медиа-частей.
196
+ *
197
+ * Сервер строит `content` из частей, но маркер может прийти уже из композера
198
+ * (пользователь набрал его сам или он был вставлен при прикреплении). Поэтому
199
+ * добавляются только те плейсхолдеры, которых в тексте ещё нет — иначе один
200
+ * файл дал бы два вхождения. Не-медиа части игнорируются; пустой текст не
201
+ * получает ведущего перевода строки.
202
+ */
203
+ export function appendMediaPlaceholders(text, parts) {
204
+ let result = text;
205
+ for (const part of parts) {
206
+ if (part.type !== 'image' &&
207
+ part.type !== 'audio' &&
208
+ part.type !== 'video' &&
209
+ part.type !== 'file') {
210
+ continue;
211
+ }
212
+ const placeholder = mediaPartPlaceholder(part.type, part.data);
213
+ if (result.includes(placeholder))
214
+ continue;
215
+ result = result === '' ? placeholder : `${result}\n${placeholder}`;
216
+ }
217
+ return result;
218
+ }
103
219
  export function buildContentFromParts(parts) {
104
- return parts
105
- .map((p) => {
106
- if (p.type === 'text')
107
- return String(p.data ?? '');
108
- if (p.type === 'reasoning')
109
- return `<reasoning>${String(p.data ?? '')}</reasoning>`;
220
+ const chunks = [];
221
+ for (const p of parts) {
222
+ // ADR-115: медиа-часть (вложение) — плейсхолдер с именем файла. Если он уже
223
+ // есть в тексте (маркер вставил композер или пользователь набрал вручную),
224
+ // второй раз не добавляем — иначе строковая производная задвоит вложение.
225
+ if (p.type === 'image' || p.type === 'audio' || p.type === 'video' || p.type === 'file') {
226
+ const placeholder = mediaPartPlaceholder(p.type, p.data);
227
+ if (chunks.join('\n').includes(placeholder))
228
+ continue;
229
+ chunks.push(placeholder);
230
+ continue;
231
+ }
232
+ if (p.type === 'text') {
233
+ chunks.push(String(p.data ?? ''));
234
+ continue;
235
+ }
236
+ if (p.type === 'reasoning') {
237
+ chunks.push(`<reasoning>${String(p.data ?? '')}</reasoning>`);
238
+ continue;
239
+ }
110
240
  if (p.type === 'tool_use') {
111
241
  const d = p.data;
112
- return `<tool_call name="${d.name ?? ''}">${JSON.stringify(d.args ?? {})}</tool_call>`;
242
+ chunks.push(`<tool_call name="${d.name ?? ''}">${JSON.stringify(d.args ?? {})}</tool_call>`);
243
+ continue;
113
244
  }
114
245
  if (p.type === 'tool_result') {
115
246
  const d = p.data;
116
247
  const isError = d.isError ? ' error="true"' : '';
117
- return `<tool_result${isError}>${String(d.content ?? '')}</tool_result>`;
248
+ chunks.push(`<tool_result${isError}>${String(d.content ?? '')}</tool_result>`);
249
+ continue;
118
250
  }
119
251
  if (p.type === 'session_reference') {
120
252
  const d = p.data;
121
253
  const summary = d.autoSummary ?? d.auto_summary ?? '';
122
- return `<session_reference session_id="${d.sessionId ?? d.session_id ?? ''}" label="${d.label ?? ''}">${String(summary)}</session_reference>`;
254
+ chunks.push(`<session_reference session_id="${d.sessionId ?? d.session_id ?? ''}" label="${d.label ?? ''}">${String(summary)}</session_reference>`);
255
+ continue;
123
256
  }
124
- return '';
125
- })
126
- .join('\n');
257
+ chunks.push('');
258
+ }
259
+ return chunks.join('\n');
127
260
  }
128
261
  // --- Provider icon helpers (общие для core/backend роутеров провайдеров) ---
129
262
  /** Favicon по origin базового URL провайдера; undefined — URL некорректен/пуст. */
@@ -0,0 +1,16 @@
1
+ /** Блок рассуждений: текст и итерация Tool Use, к которой он относится. */
2
+ export interface ReasoningBlock {
3
+ text: string;
4
+ iteration: number;
5
+ }
6
+ /**
7
+ * Накопить блок рассуждений: текст от провайдера кумулятивный, поэтому
8
+ * продолжение заменяет последний блок, точный дубль не добавляется.
9
+ *
10
+ * Порядок правил важен: «продолжение того же рассуждения» (`startsWith`)
11
+ * проверяется раньше дедупа — иначе каждый следующий кумулятивный чанк давал бы
12
+ * новый блок, а рестарт попытки (текст снова с нуля) — блок-дубль.
13
+ *
14
+ * Вход не мутируется: изменённые ветки возвращают новый массив.
15
+ */
16
+ export declare function appendReasoningBlock(blocks: readonly ReasoningBlock[], text: string, iteration: number): ReasoningBlock[];
@@ -0,0 +1,37 @@
1
+ // Накопление блоков рассуждений (reasoning) модели
2
+ /**
3
+ * Накопить блок рассуждений: текст от провайдера кумулятивный, поэтому
4
+ * продолжение заменяет последний блок, точный дубль не добавляется.
5
+ *
6
+ * Порядок правил важен: «продолжение того же рассуждения» (`startsWith`)
7
+ * проверяется раньше дедупа — иначе каждый следующий кумулятивный чанк давал бы
8
+ * новый блок, а рестарт попытки (текст снова с нуля) — блок-дубль.
9
+ *
10
+ * Вход не мутируется: изменённые ветки возвращают новый массив.
11
+ */
12
+ export function appendReasoningBlock(blocks, text, iteration) {
13
+ // 1. Пустой/пробельный текст состояния не меняет.
14
+ if (!text || !text.trim())
15
+ return [...blocks];
16
+ // 2. Первый блок.
17
+ if (blocks.length === 0)
18
+ return [{ text, iteration }];
19
+ const last = blocks[blocks.length - 1];
20
+ // 3. Тот же текст — ничего не меняем.
21
+ if (text === last.text)
22
+ return [...blocks];
23
+ // 4. Продолжение того же рассуждения (в т.ч. при смене итерации) — заменяем
24
+ // последний блок, а не добавляем новый.
25
+ if (text.startsWith(last.text)) {
26
+ return [...blocks.slice(0, -1), { text, iteration }];
27
+ }
28
+ // 5. Пришёл более короткий вариант — рестарт/повтор той же попытки, состояние
29
+ // уже содержит более полный текст.
30
+ if (last.text.startsWith(text))
31
+ return [...blocks];
32
+ // 6. Такой текст уже есть среди блоков — точный дубль не добавляем.
33
+ if (blocks.some((block) => block.text === text))
34
+ return [...blocks];
35
+ // 7. Новое рассуждение.
36
+ return [...blocks, { text, iteration }];
37
+ }
package/dist/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const SYNTH_VERSION = "0.10.1";
1
+ export declare const SYNTH_VERSION = "0.12.3";
package/dist/version.js CHANGED
@@ -1 +1 @@
1
- export const SYNTH_VERSION = '0.10.1';
1
+ export const SYNTH_VERSION = '0.12.3';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-shared",
3
- "version": "0.10.1",
3
+ "version": "0.12.3",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -48,7 +48,7 @@
48
48
  },
49
49
  "dependencies": {
50
50
  "js-yaml": "^4.1.1",
51
- "zod": "^3.24.0"
51
+ "zod": "^4.6.7"
52
52
  },
53
53
  "devDependencies": {
54
54
  "@types/js-yaml": "^4.0.9",