@itphx/synth-storage-postgres 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.
Files changed (33) hide show
  1. package/dist/migrations/028-message-reasoning-signature.d.ts +13 -0
  2. package/dist/migrations/028-message-reasoning-signature.js +19 -0
  3. package/dist/migrations/029-message-stream-v2.d.ts +22 -0
  4. package/dist/migrations/029-message-stream-v2.js +33 -0
  5. package/dist/migrations/030-session-retry.d.ts +12 -0
  6. package/dist/migrations/030-session-retry.js +16 -0
  7. package/dist/migrations/031-ssh-key-policy.d.ts +13 -0
  8. package/dist/migrations/031-ssh-key-policy.js +25 -0
  9. package/dist/migrations/032-mcp-remote-mode.d.ts +14 -0
  10. package/dist/migrations/032-mcp-remote-mode.js +18 -0
  11. package/dist/migrations/033-session-source-id.d.ts +16 -0
  12. package/dist/migrations/033-session-source-id.js +21 -0
  13. package/dist/migrations/034-pending-approvals.d.ts +18 -0
  14. package/dist/migrations/034-pending-approvals.js +35 -0
  15. package/dist/migrations/index.js +14 -0
  16. package/dist/ports/content.js +80 -9
  17. package/dist/ports/context-files.d.ts +3 -0
  18. package/dist/ports/context-files.js +9 -0
  19. package/dist/ports/events-scheduler.js +19 -11
  20. package/dist/ports/pending-approvals.d.ts +32 -0
  21. package/dist/ports/pending-approvals.js +108 -0
  22. package/dist/ports/principals-defaults.js +20 -0
  23. package/dist/ports/principals-projects.js +80 -48
  24. package/dist/ports/principals-settings.js +76 -0
  25. package/dist/ports/sessions-mapping.d.ts +70 -5
  26. package/dist/ports/sessions-mapping.js +124 -7
  27. package/dist/ports/sessions.d.ts +56 -10
  28. package/dist/ports/sessions.js +127 -25
  29. package/dist/ports/worktrees.d.ts +3 -3
  30. package/dist/ports/worktrees.js +3 -3
  31. package/dist/storage-context.d.ts +1 -1
  32. package/dist/storage-context.js +8 -2
  33. package/package.json +5 -5
@@ -0,0 +1,32 @@
1
+ /**
2
+ * PG-реализация порта **ожиданий подтверждения прав** (ADR-029, ADR-097).
3
+ *
4
+ * Таблица `pending_approvals` (миграция 035): состав ожидания (тул, аргументы,
5
+ * причина, «виновник») и метаданные (сессия, владелец, момент публикации,
6
+ * таймаут, ход, принципал). Выборка — по сессии.
7
+ *
8
+ * Почему отдельная таблица, а не поле документа сессии: `sessions` пишется
9
+ * полной перезаменой (`save`), а результаты параллельных тулов — точечно
10
+ * (`appendMessage`, ADR-118 §4). Запись ожидания в тот же документ затирала бы
11
+ * точечные записи → гонка lost update.
12
+ *
13
+ * Семантика повторяет файловые реализации core (`FilePendingApprovalStore`) и
14
+ * in-memory (`MemoryPendingApprovalRepository`): upsert по `approvalId`,
15
+ * список с фильтром по сессии, `delete` идемпотентно, `clear` — число снятых
16
+ * записей.
17
+ */
18
+ import type { PendingApprovalRecord, PendingApprovalRepository, StorageContext } from '@itphx/synth-core';
19
+ import type { PortDeps } from './deps.js';
20
+ /** Часть `StorageContext`, которой владеет группа «ожидания подтверждений». */
21
+ export type PendingApprovalPorts = Pick<StorageContext, 'pendingApprovals'>;
22
+ /** Порт ожиданий подтверждения прав поверх таблицы `pending_approvals`. */
23
+ export declare class PgPendingApprovalRepository implements PendingApprovalRepository {
24
+ private readonly _deps;
25
+ constructor(_deps: PortDeps);
26
+ save(record: PendingApprovalRecord): Promise<void>;
27
+ delete(approvalId: string): Promise<void>;
28
+ list(sessionId?: string): Promise<PendingApprovalRecord[]>;
29
+ clear(sessionId?: string): Promise<number>;
30
+ }
31
+ /** Собрать порт ожиданий подтверждения прав (ADR-029). */
32
+ export declare function buildPendingApprovalPorts(deps: PortDeps): PendingApprovalPorts;
@@ -0,0 +1,108 @@
1
+ /**
2
+ * PG-реализация порта **ожиданий подтверждения прав** (ADR-029, ADR-097).
3
+ *
4
+ * Таблица `pending_approvals` (миграция 035): состав ожидания (тул, аргументы,
5
+ * причина, «виновник») и метаданные (сессия, владелец, момент публикации,
6
+ * таймаут, ход, принципал). Выборка — по сессии.
7
+ *
8
+ * Почему отдельная таблица, а не поле документа сессии: `sessions` пишется
9
+ * полной перезаменой (`save`), а результаты параллельных тулов — точечно
10
+ * (`appendMessage`, ADR-118 §4). Запись ожидания в тот же документ затирала бы
11
+ * точечные записи → гонка lost update.
12
+ *
13
+ * Семантика повторяет файловые реализации core (`FilePendingApprovalStore`) и
14
+ * in-memory (`MemoryPendingApprovalRepository`): upsert по `approvalId`,
15
+ * список с фильтром по сессии, `delete` идемпотентно, `clear` — число снятых
16
+ * записей.
17
+ */
18
+ import { jsonbParam } from '../json-param.js';
19
+ import { toIsoRequired } from './events-core.js';
20
+ /** Запись ожидания из колонок. */
21
+ function toRecord(row) {
22
+ const trigger = row.trigger && typeof row.trigger === 'object' && !Array.isArray(row.trigger)
23
+ ? row.trigger
24
+ : undefined;
25
+ return {
26
+ approvalId: row.approval_id,
27
+ sessionId: row.session_id,
28
+ ...(row.owner_id ? { ownerId: row.owner_id } : {}),
29
+ toolName: row.tool_name,
30
+ arguments: (row.arguments && typeof row.arguments === 'object' && !Array.isArray(row.arguments))
31
+ ? row.arguments
32
+ : {},
33
+ reason: row.reason ?? '',
34
+ ...(trigger ? { trigger } : {}),
35
+ askedAt: toIsoRequired(row.asked_at),
36
+ timeoutMs: row.timeout_ms ?? 0,
37
+ ...(row.turn_id ? { turnId: row.turn_id } : {}),
38
+ ...(row.principal ? { principal: row.principal } : {}),
39
+ };
40
+ }
41
+ /** Порт ожиданий подтверждения прав поверх таблицы `pending_approvals`. */
42
+ export class PgPendingApprovalRepository {
43
+ _deps;
44
+ constructor(_deps) {
45
+ this._deps = _deps;
46
+ }
47
+ async save(record) {
48
+ await this._deps.connection.query(`INSERT INTO pending_approvals
49
+ (approval_id, session_id, owner_id, tool_name, arguments, reason, trigger,
50
+ asked_at, timeout_ms, turn_id, principal)
51
+ VALUES ($1, $2, $3, $4, $5::jsonb, $6, $7::jsonb, $8::timestamptz, $9, $10, $11)
52
+ ON CONFLICT (approval_id) DO UPDATE SET
53
+ session_id = EXCLUDED.session_id,
54
+ owner_id = EXCLUDED.owner_id,
55
+ tool_name = EXCLUDED.tool_name,
56
+ arguments = EXCLUDED.arguments,
57
+ reason = EXCLUDED.reason,
58
+ trigger = EXCLUDED.trigger,
59
+ asked_at = EXCLUDED.asked_at,
60
+ timeout_ms = EXCLUDED.timeout_ms,
61
+ turn_id = EXCLUDED.turn_id,
62
+ principal = EXCLUDED.principal`, [
63
+ record.approvalId,
64
+ record.sessionId,
65
+ record.ownerId ?? null,
66
+ record.toolName,
67
+ jsonbParam(record.arguments ?? {}),
68
+ record.reason ?? '',
69
+ record.trigger ? jsonbParam(record.trigger) : null,
70
+ record.askedAt,
71
+ record.timeoutMs ?? 0,
72
+ record.turnId ?? null,
73
+ record.principal ?? null,
74
+ ]);
75
+ }
76
+ async delete(approvalId) {
77
+ await this._deps.connection.query('DELETE FROM pending_approvals WHERE approval_id = $1', [approvalId]);
78
+ }
79
+ async list(sessionId) {
80
+ const params = [];
81
+ let sql = 'SELECT * FROM pending_approvals';
82
+ if (sessionId !== undefined) {
83
+ params.push(sessionId);
84
+ sql += ` WHERE session_id = $${params.length}`;
85
+ }
86
+ // Порядок — «сначала опубликованные» (asked_at возраст., тайбрейкер id).
87
+ sql += ' ORDER BY asked_at ASC, approval_id ASC';
88
+ const rows = await this._deps.connection.query(sql, params);
89
+ return rows.map(toRecord);
90
+ }
91
+ async clear(sessionId) {
92
+ const params = [];
93
+ let sql = 'DELETE FROM pending_approvals';
94
+ if (sessionId !== undefined) {
95
+ params.push(sessionId);
96
+ sql += ` WHERE session_id = $${params.length}`;
97
+ }
98
+ sql += ' RETURNING approval_id';
99
+ const rows = await this._deps.connection.query(sql, params);
100
+ return rows.length;
101
+ }
102
+ }
103
+ /** Собрать порт ожиданий подтверждения прав (ADR-029). */
104
+ export function buildPendingApprovalPorts(deps) {
105
+ return {
106
+ pendingApprovals: new PgPendingApprovalRepository(deps),
107
+ };
108
+ }
@@ -17,6 +17,9 @@ export const DEFAULTS_SETTINGS_KEY = 'defaults';
17
17
  /** Минимальный/максимальный допустимый масштаб интерфейса (паритет `DefaultsStore`). */
18
18
  const UI_SCALE_MIN = 0.5;
19
19
  const UI_SCALE_MAX = 1.2;
20
+ /** Диапазон масштаба области чата (паритет `DefaultsStore`/UI `CHAT_SCALE_*`). */
21
+ const CHAT_SCALE_MIN = 0.75;
22
+ const CHAT_SCALE_MAX = 1.5;
20
23
  /** Масштаб интерфейса: число в диапазоне 0.5..1.2, иначе `undefined`. */
21
24
  function sanitizeScale(value) {
22
25
  if (typeof value === 'number' && Number.isFinite(value) && value >= UI_SCALE_MIN && value <= UI_SCALE_MAX) {
@@ -24,6 +27,13 @@ function sanitizeScale(value) {
24
27
  }
25
28
  return undefined;
26
29
  }
30
+ /** Масштаб области чата: число в диапазоне 0.75..1.5, иначе `undefined`. */
31
+ function sanitizeChatScale(value) {
32
+ if (typeof value === 'number' && Number.isFinite(value) && value >= CHAT_SCALE_MIN && value <= CHAT_SCALE_MAX) {
33
+ return value;
34
+ }
35
+ return undefined;
36
+ }
27
37
  /** Оставить только валидные поля умолчаний оформления (паритет `DefaultsStore`). */
28
38
  function sanitize(raw) {
29
39
  if (typeof raw !== 'object' || raw === null)
@@ -43,6 +53,16 @@ function sanitize(raw) {
43
53
  const desktop = sanitizeScale(src.uiScaleDesktop);
44
54
  if (desktop !== undefined)
45
55
  out.uiScaleDesktop = desktop;
56
+ if (src.chatViewMode === 'detailed' || src.chatViewMode === 'feed')
57
+ out.chatViewMode = src.chatViewMode;
58
+ if (src.chatDensity === 'normal' || src.chatDensity === 'compact')
59
+ out.chatDensity = src.chatDensity;
60
+ const chatMobile = sanitizeChatScale(src.chatScaleMobile);
61
+ if (chatMobile !== undefined)
62
+ out.chatScaleMobile = chatMobile;
63
+ const chatDesktop = sanitizeChatScale(src.chatScaleDesktop);
64
+ if (chatDesktop !== undefined)
65
+ out.chatScaleDesktop = chatDesktop;
46
66
  return out;
47
67
  }
48
68
  /** Прочитать умолчания оформления (без блокировки — чтение). */
@@ -48,6 +48,61 @@ function rowToProject(row) {
48
48
  updatedAt: requiredIso(row.updated_at),
49
49
  };
50
50
  }
51
+ /**
52
+ * Запись проекта в БД (строка + набор участий) **тем же соединением/транзакцией**,
53
+ * что и вызывающий: `save` и `mutate` не дублируют SQL и не открывают вложенную
54
+ * транзакцию.
55
+ */
56
+ async function writeProject(tx, project) {
57
+ await tx.query(`INSERT INTO projects (
58
+ id, name, owner_id, description, current_task, invariants, icon, color,
59
+ workspace, plan, log, status_messages, repos, mcp, skills, memory, created_at, updated_at
60
+ ) VALUES (
61
+ $1, $2, $3, $4, $5, $6, $7, $8,
62
+ $9, $10::jsonb, $11::jsonb, $12::jsonb, $13::jsonb, $14::jsonb, $15::jsonb, $16::jsonb, $17, $18
63
+ )
64
+ ON CONFLICT (id) DO UPDATE SET
65
+ name = EXCLUDED.name,
66
+ owner_id = EXCLUDED.owner_id,
67
+ description = EXCLUDED.description,
68
+ current_task = EXCLUDED.current_task,
69
+ invariants = EXCLUDED.invariants,
70
+ icon = EXCLUDED.icon,
71
+ color = EXCLUDED.color,
72
+ workspace = EXCLUDED.workspace,
73
+ plan = EXCLUDED.plan,
74
+ log = EXCLUDED.log,
75
+ status_messages = EXCLUDED.status_messages,
76
+ repos = EXCLUDED.repos,
77
+ mcp = EXCLUDED.mcp,
78
+ skills = EXCLUDED.skills,
79
+ memory = EXCLUDED.memory,
80
+ updated_at = EXCLUDED.updated_at`, [
81
+ project.id,
82
+ project.name,
83
+ project.ownerId,
84
+ project.description ?? '',
85
+ project.currentTask ?? '',
86
+ project.invariants ?? '',
87
+ project.icon ?? null,
88
+ project.color ?? null,
89
+ project.workspace ?? null,
90
+ jsonbParam(project.plan ?? null),
91
+ jsonbParam(project.log ?? null),
92
+ jsonbParam(project.statusMessages ?? []),
93
+ jsonbParam(project.repos ?? null),
94
+ jsonbParam(project.mcp ?? null),
95
+ jsonbParam(project.skills ?? null),
96
+ jsonbParam(project.memory ?? null),
97
+ project.createdAt,
98
+ project.updatedAt,
99
+ ]);
100
+ // Набор участий — источник истины в самом проекте: заменяем целиком.
101
+ await tx.query('DELETE FROM project_members WHERE project_id = $1', [project.id]);
102
+ for (const [userId, role] of Object.entries(project.members ?? {})) {
103
+ await tx.query('INSERT INTO project_members (project_id, user_id, role) VALUES ($1, $2, $3)', [project.id, userId, role]);
104
+ }
105
+ }
51
106
  /** Собрать порт проектов поверх SQL. */
52
107
  export function createPrincipalProjectsPort(conn) {
53
108
  return {
@@ -58,54 +113,31 @@ export function createPrincipalProjectsPort(conn) {
58
113
  },
59
114
  async save(project) {
60
115
  await conn.withTransaction(async (tx) => {
61
- await tx.query(`INSERT INTO projects (
62
- id, name, owner_id, description, current_task, invariants, icon, color,
63
- workspace, plan, log, status_messages, repos, mcp, skills, memory, created_at, updated_at
64
- ) VALUES (
65
- $1, $2, $3, $4, $5, $6, $7, $8,
66
- $9, $10::jsonb, $11::jsonb, $12::jsonb, $13::jsonb, $14::jsonb, $15::jsonb, $16::jsonb, $17, $18
67
- )
68
- ON CONFLICT (id) DO UPDATE SET
69
- name = EXCLUDED.name,
70
- owner_id = EXCLUDED.owner_id,
71
- description = EXCLUDED.description,
72
- current_task = EXCLUDED.current_task,
73
- invariants = EXCLUDED.invariants,
74
- icon = EXCLUDED.icon,
75
- color = EXCLUDED.color,
76
- workspace = EXCLUDED.workspace,
77
- plan = EXCLUDED.plan,
78
- log = EXCLUDED.log,
79
- status_messages = EXCLUDED.status_messages,
80
- repos = EXCLUDED.repos,
81
- mcp = EXCLUDED.mcp,
82
- skills = EXCLUDED.skills,
83
- memory = EXCLUDED.memory,
84
- updated_at = EXCLUDED.updated_at`, [
85
- project.id,
86
- project.name,
87
- project.ownerId,
88
- project.description ?? '',
89
- project.currentTask ?? '',
90
- project.invariants ?? '',
91
- project.icon ?? null,
92
- project.color ?? null,
93
- project.workspace ?? null,
94
- jsonbParam(project.plan ?? null),
95
- jsonbParam(project.log ?? null),
96
- jsonbParam(project.statusMessages ?? []),
97
- jsonbParam(project.repos ?? null),
98
- jsonbParam(project.mcp ?? null),
99
- jsonbParam(project.skills ?? null),
100
- jsonbParam(project.memory ?? null),
101
- project.createdAt,
102
- project.updatedAt,
103
- ]);
104
- // Набор участий — источник истины в самом проекте: заменяем целиком.
105
- await tx.query('DELETE FROM project_members WHERE project_id = $1', [project.id]);
106
- for (const [userId, role] of Object.entries(project.members ?? {})) {
107
- await tx.query('INSERT INTO project_members (project_id, user_id, role) VALUES ($1, $2, $3)', [project.id, userId, role]);
108
- }
116
+ await writeProject(tx, project);
117
+ });
118
+ },
119
+ /**
120
+ * Атомарный read-modify-write (порт `ProjectRepository.mutate`): блокировка
121
+ * строки `projects` и запись в **одной** транзакции, поэтому параллельные
122
+ * мутации одного проекта сериализуются и не теряют правки друг друга.
123
+ *
124
+ * `FOR UPDATE OF p` — обязательный: `SELECT_PROJECT` содержит
125
+ * `LEFT JOIN LATERAL`, а `FOR UPDATE` без `OF` PostgreSQL отвергает
126
+ * («cannot be applied to the nullable side of an outer join»). `OF p`
127
+ * блокирует только строку проекта (строка агрегата `members` — подзапрос,
128
+ * её lock не нужен: чтение участий идёт в той же транзакции-снимке, а запись
129
+ * заменяет набор под той же блокировкой).
130
+ */
131
+ async mutate(id, mutator) {
132
+ return conn.withTransaction(async (tx) => {
133
+ const rows = await tx.query(`${SELECT_PROJECT} WHERE p.id = $1 FOR UPDATE OF p`, [id]);
134
+ const row = rows[0];
135
+ if (!row)
136
+ return null;
137
+ const project = rowToProject(row);
138
+ mutator(project);
139
+ await writeProject(tx, project);
140
+ return project;
109
141
  });
110
142
  },
111
143
  async delete(id) {
@@ -30,6 +30,7 @@ const SECTION_KEYS = [
30
30
  'skillsDisabled',
31
31
  'skillsDisabledForNewProjects',
32
32
  'skillsPolicy',
33
+ 'skillsTrustedProjectDirs',
33
34
  'mcpNetworkPolicy',
34
35
  'egress',
35
36
  'defaultAgent',
@@ -40,6 +41,7 @@ const SECTION_KEYS = [
40
41
  'proxy',
41
42
  'plugins',
42
43
  'attachments',
44
+ 'sessionOpsPerMinute',
43
45
  ];
44
46
  const SECTION_KEY_SET = new Set(SECTION_KEYS);
45
47
  /** Собрать порт runtime-настроек поверх SQL. */
@@ -167,6 +169,15 @@ export function createPrincipalSettingsPort(conn) {
167
169
  async clearSkillsPolicy() {
168
170
  await deleteSetting(conn, 'skillsPolicy');
169
171
  },
172
+ async getSkillsTrustedProjectDirs() {
173
+ return readSetting(conn, 'skillsTrustedProjectDirs');
174
+ },
175
+ async setSkillsTrustedProjectDirs(dirs) {
176
+ await writeSetting(conn, 'skillsTrustedProjectDirs', dirs);
177
+ },
178
+ async clearSkillsTrustedProjectDirs() {
179
+ await deleteSetting(conn, 'skillsTrustedProjectDirs');
180
+ },
170
181
  async getTokenRatio(model) {
171
182
  const rows = await conn.query('SELECT ratio FROM token_ratios WHERE model = $1', [model]);
172
183
  return rows[0]?.ratio;
@@ -264,6 +275,16 @@ export function createPrincipalSettingsPort(conn) {
264
275
  async clearMetrics() {
265
276
  await deleteSetting(conn, 'metrics');
266
277
  },
278
+ // ADR-133: runtime-тумблер автоматической проверки обновлений.
279
+ async getUpdates() {
280
+ return (await readSetting(conn, 'updates')) ?? {};
281
+ },
282
+ async setUpdates(config) {
283
+ await writeSetting(conn, 'updates', config);
284
+ },
285
+ async clearUpdates() {
286
+ await deleteSetting(conn, 'updates');
287
+ },
267
288
  async getPlugins() {
268
289
  return (await readSetting(conn, 'plugins')) ?? {};
269
290
  },
@@ -291,5 +312,60 @@ export function createPrincipalSettingsPort(conn) {
291
312
  async clearAttachments() {
292
313
  await deleteSetting(conn, 'attachments');
293
314
  },
315
+ async getContextWindowPolicy() {
316
+ return readSetting(conn, 'contextWindowPolicy');
317
+ },
318
+ async setContextWindowPolicy(policy) {
319
+ await writeSetting(conn, 'contextWindowPolicy', policy);
320
+ },
321
+ async clearContextWindowPolicy() {
322
+ await deleteSetting(conn, 'contextWindowPolicy');
323
+ },
324
+ async getSubagentMaxInputTokens() {
325
+ return readSetting(conn, 'subagentMaxInputTokens');
326
+ },
327
+ async setSubagentMaxInputTokens(value) {
328
+ await writeSetting(conn, 'subagentMaxInputTokens', value);
329
+ },
330
+ async clearSubagentMaxInputTokens() {
331
+ await deleteSetting(conn, 'subagentMaxInputTokens');
332
+ },
333
+ async getSessionOpsPerMinute() {
334
+ return readSetting(conn, 'sessionOpsPerMinute');
335
+ },
336
+ async setSessionOpsPerMinute(value) {
337
+ await writeSetting(conn, 'sessionOpsPerMinute', value);
338
+ },
339
+ async clearSessionOpsPerMinute() {
340
+ await deleteSetting(conn, 'sessionOpsPerMinute');
341
+ },
342
+ async getContextDefaults() {
343
+ return readSetting(conn, 'contextDefaults');
344
+ },
345
+ async setContextDefaults(defaults) {
346
+ await writeSetting(conn, 'contextDefaults', defaults);
347
+ },
348
+ async clearContextDefaults() {
349
+ await deleteSetting(conn, 'contextDefaults');
350
+ },
351
+ async getStickyNotesLimits() {
352
+ return readSetting(conn, 'stickyNotesLimits');
353
+ },
354
+ async setStickyNotesLimits(limits) {
355
+ await writeSetting(conn, 'stickyNotesLimits', limits);
356
+ },
357
+ async clearStickyNotesLimits() {
358
+ await deleteSetting(conn, 'stickyNotesLimits');
359
+ },
360
+ // PROP-124: режим инстанса для SSH-ключей (`ssh.mode`).
361
+ async getSshMode() {
362
+ return readSetting(conn, 'sshMode');
363
+ },
364
+ async setSshMode(mode) {
365
+ await writeSetting(conn, 'sshMode', mode);
366
+ },
367
+ async clearSshMode() {
368
+ await deleteSetting(conn, 'sshMode');
369
+ },
294
370
  };
295
371
  }
@@ -18,7 +18,7 @@
18
18
  * `buildContentFromParts`, `generateId`) берутся напрямую из
19
19
  * `@itphx/synth-shared` — обычной зависимости драйвера (ADR-097).
20
20
  */
21
- import { type Checkpoint, type Message, type Session, type SessionReference, type SessionWorktree, type StickyNote } from '@itphx/synth-shared';
21
+ import { type Checkpoint, type Message, type Part, type Session, type SessionReference, type SessionRetryState, type SessionWorktree, type StickyNote } from '@itphx/synth-shared';
22
22
  /** Строка `sessions` (jsonb — уже разобранные значения; `bigint` — строка). */
23
23
  export interface SessionRow {
24
24
  id: string;
@@ -35,6 +35,12 @@ export interface SessionRow {
35
35
  user_id: string | null;
36
36
  owner_id: string | null;
37
37
  project_id: string | null;
38
+ /**
39
+ * Маркер источника при переносе между инстансами (`Session.sourceSessionId`),
40
+ * ключ дедупликации повторного импорта (миграция `033`). В записях, созданных
41
+ * до миграции, поля нет — чтение даёт `undefined`.
42
+ */
43
+ source_session_id?: string | null;
38
44
  /**
39
45
  * ADR-114: привязка сессии к worktree (jsonb). В записях, созданных до
40
46
  * миграции `023`, поля нет — чтение даёт `undefined`.
@@ -50,6 +56,11 @@ export interface SessionRow {
50
56
  /** ADR-104: очередь инъекций (steering) — отдельно от `pending_messages`. */
51
57
  steer_inbox: unknown;
52
58
  current_stream: unknown;
59
+ /**
60
+ * Персистентное состояние ретрая сессии (jsonb, миграция `030`). В записях,
61
+ * созданных до миграции, поля нет — чтение даёт `undefined`.
62
+ */
63
+ retry?: unknown;
53
64
  summarization_pending: boolean;
54
65
  can_summarize: boolean;
55
66
  created_at: string | Date;
@@ -73,6 +84,17 @@ export interface MessageRow {
73
84
  id: string;
74
85
  session_id?: string;
75
86
  seq: number;
87
+ /**
88
+ * ADR-118 §2: **монотонный** счётчик порядка записи в историю сессии.
89
+ * В записях до миграции `029` колонки нет — чтение даёт `undefined`.
90
+ */
91
+ ord?: number | null;
92
+ /** ADR-118 §1: идентификатор хода (`Turn`). */
93
+ turn_id?: string | null;
94
+ /** ADR-118 §1: индекс шага внутри хода (0-based). */
95
+ step_index?: number | null;
96
+ /** ADR-118 §5: статус сообщения-хода (`streaming`/`completed`/`cancelled`/`error`). */
97
+ status?: string | null;
76
98
  role: string;
77
99
  origin: string;
78
100
  source_msg_id?: string | null;
@@ -89,6 +111,10 @@ export interface MessageRow {
89
111
  provider?: string | null;
90
112
  provider_type?: string | null;
91
113
  reasoning?: string | null;
114
+ /** Anthropic: подпись thinking-блока (миграция `028`). */
115
+ reasoning_signature?: string | null;
116
+ /** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
117
+ reasoning_redacted?: unknown;
92
118
  source?: string | null;
93
119
  author?: string | null;
94
120
  agent_role?: string | null;
@@ -136,11 +162,13 @@ export interface SessionChildren {
136
162
  }
137
163
  /** Пустой набор child-данных (сессия без сообщений/ссылок/чекпоинтов). */
138
164
  export declare function emptySessionChildren(): SessionChildren;
139
- /** Часть сообщения в форме хранения (`{id, type, data}`). */
165
+ /** Часть сообщения в форме хранения (`{id, type, data}` + аддитивные `metadata`). */
140
166
  export interface SerializedPart {
141
167
  id: string;
142
168
  type: string;
143
169
  data: unknown;
170
+ /** Anthropic thinking: подпись/redacted части (аддитивное поле). */
171
+ metadata?: Part['metadata'];
144
172
  }
145
173
  /** Usage сообщения в форме хранения (snake_case — как в файловом backend). */
146
174
  export interface SerializedUsage {
@@ -156,6 +184,16 @@ export interface SerializedMessage {
156
184
  id: string;
157
185
  role: string;
158
186
  seq: number;
187
+ /**
188
+ * ADR-118 §2: монотонный порядок записи (`ord`) — **не** перенумеровывается.
189
+ */
190
+ ord?: number;
191
+ /** ADR-118 §1: ход (`turn_id`). */
192
+ turn_id?: string;
193
+ /** ADR-118 §1: шаг внутри хода (`step_index`, 0-based). */
194
+ step_index?: number;
195
+ /** ADR-118 §5: статус сообщения. */
196
+ status?: string;
159
197
  origin: string;
160
198
  source_msg_id?: string;
161
199
  parts: SerializedPart[];
@@ -173,6 +211,10 @@ export interface SerializedMessage {
173
211
  provider_type?: string;
174
212
  usage?: SerializedUsage;
175
213
  reasoning?: string;
214
+ /** Anthropic: подпись thinking-блока (миграция `028`). */
215
+ reasoning_signature?: string;
216
+ /** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
217
+ reasoning_redacted?: string[];
176
218
  source?: string;
177
219
  author?: string;
178
220
  agent_role?: string;
@@ -190,6 +232,8 @@ export declare function toIsoOrUndefined(value: unknown): string | undefined;
190
232
  export declare function toNumber(value: unknown, fallback?: number): number;
191
233
  /** Необязательное число (nullable-колонка). */
192
234
  export declare function toNumberOrUndefined(value: unknown): number | undefined;
235
+ /** Статус сообщения из колонки `status` (неизвестное значение → `undefined`). */
236
+ export declare function toMessageStatus(value: unknown): Message['status'];
193
237
  /** Сообщение → форма хранения (дословно `serializeMessage` файловой реализации). */
194
238
  export declare function serializeMessage(msg: Message): SerializedMessage;
195
239
  /**
@@ -238,6 +282,14 @@ export declare function deserializeStickyNote(row: StickyNoteRow): StickyNote;
238
282
  * игнорируется, сессия работает как прежде.
239
283
  */
240
284
  export declare function deserializeSessionWorktree(data: unknown): SessionWorktree | undefined;
285
+ /**
286
+ * Значение `sessions.retry` → доменное состояние ретрая.
287
+ *
288
+ * Форма хранения — snake_case (`stream_id`/`attempt`/`max_retries`/`retry_at`/
289
+ * `error`), как в JSON-файловом backend. Legacy-записи (без поля) и битые
290
+ * значения читаются как «ретрая нет» (`undefined`).
291
+ */
292
+ export declare function deserializeSessionRetry(data: unknown): SessionRetryState | undefined;
241
293
  /**
242
294
  * Строка `sessions` + child-данные → доменная сессия: дословный
243
295
  * `deserializeSession` файловой реализации (нормализация иконки/цвета,
@@ -247,8 +299,21 @@ export declare function deserializeSessionWorktree(data: unknown): SessionWorktr
247
299
  export declare function deserializeSession(row: SessionRow, children: SessionChildren): Session;
248
300
  /**
249
301
  * Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
250
- * ADR-097): `messages`/`pendingMessages`/`checkpoints` пусты, child-таблицы не
251
- * читаются. Метаданные (id/статус/settings/projectId/expiresAt/…) идентичны
252
- * `deserializeSession` — механика переиспользуется.
302
+ * ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
303
+ * сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
304
+ * истории не тянут, нужны recovery/автозапуску). Метаданные
305
+ * (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
306
+ * механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
253
307
  */
254
308
  export declare function deserializeSessionLight(row: SessionRow): Session;
309
+ /**
310
+ * Строка `sessions` → доменная сессия **без истории и без очереди**
311
+ * (`SessionRepository.loadLight`, ADR-097): `messages`/`checkpoints` пусты и
312
+ * `pendingMessages`/`steerInbox` **тоже** — контракт порта (`loadLight`
313
+ * возвращает только атрибуты сессии, очередь нужна лишь recovery/автозапуску
314
+ * через `listLight`). Child-таблицы не читаются.
315
+ *
316
+ * Строится поверх `deserializeSessionLight` (та же метапроекция), поэтому
317
+ * остальные поля идентичны `deserializeSession`; отличается только очередь.
318
+ */
319
+ export declare function deserializeSessionMeta(row: SessionRow): Session;