@itphx/synth-storage-postgres 0.11.3 → 0.13.4
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/errors.d.ts +1 -1
- package/dist/errors.js +2 -2
- package/dist/index.d.ts +15 -1
- package/dist/index.js +24 -2
- package/dist/locks.d.ts +4 -4
- package/dist/locks.js +4 -4
- package/dist/migrate.d.ts +1 -1
- package/dist/migrate.js +1 -1
- package/dist/migrations/001-init.d.ts +2 -2
- package/dist/migrations/001-init.js +2 -2
- package/dist/migrations/003-analytics-rollups.d.ts +1 -1
- package/dist/migrations/003-analytics-rollups.js +1 -1
- package/dist/migrations/004-pipeline-engine.d.ts +19 -0
- package/dist/migrations/004-pipeline-engine.js +74 -0
- package/dist/migrations/005-pipeline-provenance.d.ts +12 -0
- package/dist/migrations/005-pipeline-provenance.js +15 -0
- package/dist/migrations/006-plugin-audit.d.ts +13 -0
- package/dist/migrations/006-plugin-audit.js +34 -0
- package/dist/migrations/007-plugin-lock.d.ts +10 -0
- package/dist/migrations/007-plugin-lock.js +25 -0
- package/dist/migrations/008-plugin-audit-scan.d.ts +11 -0
- package/dist/migrations/008-plugin-audit-scan.js +15 -0
- package/dist/migrations/009-plugin-lock-previous.d.ts +13 -0
- package/dist/migrations/009-plugin-lock-previous.js +16 -0
- package/dist/migrations/010-plugin-lock-mode.d.ts +16 -0
- package/dist/migrations/010-plugin-lock-mode.js +20 -0
- package/dist/migrations/011-session-steer-inbox.d.ts +11 -0
- package/dist/migrations/011-session-steer-inbox.js +14 -0
- package/dist/migrations/012-external-credentials.d.ts +15 -0
- package/dist/migrations/012-external-credentials.js +40 -0
- package/dist/migrations/013-service-key-plugin-id.d.ts +17 -0
- package/dist/migrations/013-service-key-plugin-id.js +20 -0
- package/dist/migrations/014-session-mode-by-principal.d.ts +12 -0
- package/dist/migrations/014-session-mode-by-principal.js +15 -0
- package/dist/migrations/015-authority.d.ts +17 -0
- package/dist/migrations/015-authority.js +43 -0
- package/dist/migrations/016-credential-audit.d.ts +17 -0
- package/dist/migrations/016-credential-audit.js +32 -0
- package/dist/migrations/017-memory.d.ts +29 -0
- package/dist/migrations/017-memory.js +95 -0
- package/dist/migrations/018-memory-index-scope.d.ts +14 -0
- package/dist/migrations/018-memory-index-scope.js +18 -0
- package/dist/migrations/019-memory-index-enabled.d.ts +11 -0
- package/dist/migrations/019-memory-index-enabled.js +14 -0
- package/dist/migrations/020-project-memory.d.ts +11 -0
- package/dist/migrations/020-project-memory.js +13 -0
- package/dist/migrations/021-background-runs.d.ts +17 -0
- package/dist/migrations/021-background-runs.js +67 -0
- package/dist/migrations/022-background-run-process-id.d.ts +14 -0
- package/dist/migrations/022-background-run-process-id.js +18 -0
- package/dist/migrations/023-session-worktree.d.ts +12 -0
- package/dist/migrations/023-session-worktree.js +16 -0
- package/dist/migrations/024-blob-refs.d.ts +15 -0
- package/dist/migrations/024-blob-refs.js +26 -0
- package/dist/migrations/025-packs-pipelines.d.ts +28 -0
- package/dist/migrations/025-packs-pipelines.js +82 -0
- package/dist/migrations/026-instance-skills.d.ts +17 -0
- package/dist/migrations/026-instance-skills.js +25 -0
- package/dist/migrations/027-context-files.d.ts +20 -0
- package/dist/migrations/027-context-files.js +30 -0
- package/dist/migrations/028-message-reasoning-signature.d.ts +13 -0
- package/dist/migrations/028-message-reasoning-signature.js +19 -0
- package/dist/migrations/029-message-stream-v2.d.ts +22 -0
- package/dist/migrations/029-message-stream-v2.js +33 -0
- package/dist/migrations/030-session-retry.d.ts +12 -0
- package/dist/migrations/030-session-retry.js +16 -0
- package/dist/migrations/index.d.ts +1 -1
- package/dist/migrations/index.js +55 -1
- package/dist/pool.d.ts +6 -6
- package/dist/pool.js +8 -8
- package/dist/ports/analytics.d.ts +1 -1
- package/dist/ports/analytics.js +1 -1
- package/dist/ports/audit.d.ts +1 -1
- package/dist/ports/audit.js +3 -0
- package/dist/ports/authority.d.ts +27 -0
- package/dist/ports/authority.js +148 -0
- package/dist/ports/background-runs.d.ts +41 -0
- package/dist/ports/background-runs.js +179 -0
- package/dist/ports/blob-refs.d.ts +36 -0
- package/dist/ports/blob-refs.js +55 -0
- package/dist/ports/content.d.ts +1 -1
- package/dist/ports/content.js +21 -7
- package/dist/ports/context-files.d.ts +147 -0
- package/dist/ports/context-files.js +285 -0
- package/dist/ports/core-sync.d.ts +1 -1
- package/dist/ports/core-sync.js +1 -1
- package/dist/ports/credential-audit.d.ts +19 -0
- package/dist/ports/credential-audit.js +96 -0
- package/dist/ports/deps.d.ts +2 -2
- package/dist/ports/deps.js +1 -1
- package/dist/ports/events-bindings.d.ts +2 -2
- package/dist/ports/events-bindings.js +2 -2
- package/dist/ports/events-core.d.ts +1 -1
- package/dist/ports/events-core.js +1 -1
- package/dist/ports/events-journal.d.ts +1 -1
- package/dist/ports/events-journal.js +1 -1
- package/dist/ports/events-scheduler.d.ts +1 -1
- package/dist/ports/events-scheduler.js +20 -12
- package/dist/ports/events-webhooks.d.ts +1 -1
- package/dist/ports/events-webhooks.js +1 -1
- package/dist/ports/events.d.ts +1 -1
- package/dist/ports/events.js +1 -1
- package/dist/ports/external-credentials.d.ts +6 -0
- package/dist/ports/external-credentials.js +363 -0
- package/dist/ports/legacy-pipelines.d.ts +50 -0
- package/dist/ports/legacy-pipelines.js +202 -0
- package/dist/ports/memory.d.ts +65 -0
- package/dist/ports/memory.js +471 -0
- package/dist/ports/packs.d.ts +32 -0
- package/dist/ports/packs.js +117 -0
- package/dist/ports/pipelines.d.ts +67 -0
- package/dist/ports/pipelines.js +297 -0
- package/dist/ports/plugin-audit.d.ts +14 -0
- package/dist/ports/plugin-audit.js +110 -0
- package/dist/ports/plugin-lock.d.ts +27 -0
- package/dist/ports/plugin-lock.js +145 -0
- package/dist/ports/principals-defaults.d.ts +1 -1
- package/dist/ports/principals-defaults.js +21 -1
- package/dist/ports/principals-documents.d.ts +1 -1
- package/dist/ports/principals-documents.js +1 -1
- package/dist/ports/principals-profiles.d.ts +1 -1
- package/dist/ports/principals-profiles.js +1 -1
- package/dist/ports/principals-projects.d.ts +1 -1
- package/dist/ports/principals-projects.js +82 -47
- package/dist/ports/principals-settings.d.ts +1 -1
- package/dist/ports/principals-settings.js +57 -1
- package/dist/ports/principals-shared.d.ts +1 -1
- package/dist/ports/principals-shared.js +1 -1
- package/dist/ports/principals.d.ts +1 -1
- package/dist/ports/principals.js +1 -1
- package/dist/ports/questions.d.ts +40 -0
- package/dist/ports/questions.js +135 -0
- package/dist/ports/sessions-mapping.d.ts +80 -6
- package/dist/ports/sessions-mapping.js +165 -8
- package/dist/ports/sessions.d.ts +62 -8
- package/dist/ports/sessions.js +96 -20
- package/dist/ports/skills.d.ts +59 -0
- package/dist/ports/skills.js +205 -0
- package/dist/ports/stub.d.ts +1 -1
- package/dist/ports/stub.js +2 -2
- package/dist/ports/worktrees.d.ts +41 -0
- package/dist/ports/worktrees.js +85 -0
- package/dist/postgres-storage.d.ts +4 -5
- package/dist/postgres-storage.js +5 -6
- package/dist/storage-context.d.ts +44 -15
- package/dist/storage-context.js +139 -31
- package/package.json +4 -4
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Отображение строк PostgreSQL ↔ доменных объектов порта `SessionRepository`
|
|
3
|
-
* (
|
|
3
|
+
* (ADR-097, волна 3b).
|
|
4
4
|
*
|
|
5
5
|
* Эталон семантики — файловая реализация (`core/src/storage/file-store.ts`):
|
|
6
6
|
* `serializeSession`/`serializeMessage` и `deserializeSession`/`deserializeMessage`
|
|
@@ -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 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;
|
|
@@ -30,9 +30,16 @@ export interface SessionRow {
|
|
|
30
30
|
branch_point: string | null;
|
|
31
31
|
plan_approved: boolean | null;
|
|
32
32
|
mode: string | null;
|
|
33
|
+
/** ADR-106 Ф4 (шаг C): режим по принципалу (переопределения режима сессии). */
|
|
34
|
+
mode_by_principal: unknown;
|
|
33
35
|
user_id: string | null;
|
|
34
36
|
owner_id: string | null;
|
|
35
37
|
project_id: string | null;
|
|
38
|
+
/**
|
|
39
|
+
* ADR-114: привязка сессии к worktree (jsonb). В записях, созданных до
|
|
40
|
+
* миграции `023`, поля нет — чтение даёт `undefined`.
|
|
41
|
+
*/
|
|
42
|
+
worktree?: unknown;
|
|
36
43
|
todos: unknown;
|
|
37
44
|
prompt_states: unknown;
|
|
38
45
|
obfuscation_map: unknown;
|
|
@@ -40,7 +47,14 @@ export interface SessionRow {
|
|
|
40
47
|
settings: unknown;
|
|
41
48
|
mcp_servers: unknown;
|
|
42
49
|
pending_messages: unknown;
|
|
50
|
+
/** ADR-104: очередь инъекций (steering) — отдельно от `pending_messages`. */
|
|
51
|
+
steer_inbox: unknown;
|
|
43
52
|
current_stream: unknown;
|
|
53
|
+
/**
|
|
54
|
+
* Персистентное состояние ретрая сессии (jsonb, миграция `030`). В записях,
|
|
55
|
+
* созданных до миграции, поля нет — чтение даёт `undefined`.
|
|
56
|
+
*/
|
|
57
|
+
retry?: unknown;
|
|
44
58
|
summarization_pending: boolean;
|
|
45
59
|
can_summarize: boolean;
|
|
46
60
|
created_at: string | Date;
|
|
@@ -64,6 +78,17 @@ export interface MessageRow {
|
|
|
64
78
|
id: string;
|
|
65
79
|
session_id?: string;
|
|
66
80
|
seq: number;
|
|
81
|
+
/**
|
|
82
|
+
* ADR-118 §2: **монотонный** счётчик порядка записи в историю сессии.
|
|
83
|
+
* В записях до миграции `029` колонки нет — чтение даёт `undefined`.
|
|
84
|
+
*/
|
|
85
|
+
ord?: number | null;
|
|
86
|
+
/** ADR-118 §1: идентификатор хода (`Turn`). */
|
|
87
|
+
turn_id?: string | null;
|
|
88
|
+
/** ADR-118 §1: индекс шага внутри хода (0-based). */
|
|
89
|
+
step_index?: number | null;
|
|
90
|
+
/** ADR-118 §5: статус сообщения-хода (`streaming`/`completed`/`cancelled`/`error`). */
|
|
91
|
+
status?: string | null;
|
|
67
92
|
role: string;
|
|
68
93
|
origin: string;
|
|
69
94
|
source_msg_id?: string | null;
|
|
@@ -80,6 +105,10 @@ export interface MessageRow {
|
|
|
80
105
|
provider?: string | null;
|
|
81
106
|
provider_type?: string | null;
|
|
82
107
|
reasoning?: string | null;
|
|
108
|
+
/** Anthropic: подпись thinking-блока (миграция `028`). */
|
|
109
|
+
reasoning_signature?: string | null;
|
|
110
|
+
/** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
|
|
111
|
+
reasoning_redacted?: unknown;
|
|
83
112
|
source?: string | null;
|
|
84
113
|
author?: string | null;
|
|
85
114
|
agent_role?: string | null;
|
|
@@ -127,11 +156,13 @@ export interface SessionChildren {
|
|
|
127
156
|
}
|
|
128
157
|
/** Пустой набор child-данных (сессия без сообщений/ссылок/чекпоинтов). */
|
|
129
158
|
export declare function emptySessionChildren(): SessionChildren;
|
|
130
|
-
/** Часть сообщения в форме хранения (`{id, type, data}`). */
|
|
159
|
+
/** Часть сообщения в форме хранения (`{id, type, data}` + аддитивные `metadata`). */
|
|
131
160
|
export interface SerializedPart {
|
|
132
161
|
id: string;
|
|
133
162
|
type: string;
|
|
134
163
|
data: unknown;
|
|
164
|
+
/** Anthropic thinking: подпись/redacted части (аддитивное поле). */
|
|
165
|
+
metadata?: Part['metadata'];
|
|
135
166
|
}
|
|
136
167
|
/** Usage сообщения в форме хранения (snake_case — как в файловом backend). */
|
|
137
168
|
export interface SerializedUsage {
|
|
@@ -147,6 +178,16 @@ export interface SerializedMessage {
|
|
|
147
178
|
id: string;
|
|
148
179
|
role: string;
|
|
149
180
|
seq: number;
|
|
181
|
+
/**
|
|
182
|
+
* ADR-118 §2: монотонный порядок записи (`ord`) — **не** перенумеровывается.
|
|
183
|
+
*/
|
|
184
|
+
ord?: number;
|
|
185
|
+
/** ADR-118 §1: ход (`turn_id`). */
|
|
186
|
+
turn_id?: string;
|
|
187
|
+
/** ADR-118 §1: шаг внутри хода (`step_index`, 0-based). */
|
|
188
|
+
step_index?: number;
|
|
189
|
+
/** ADR-118 §5: статус сообщения. */
|
|
190
|
+
status?: string;
|
|
150
191
|
origin: string;
|
|
151
192
|
source_msg_id?: string;
|
|
152
193
|
parts: SerializedPart[];
|
|
@@ -164,6 +205,10 @@ export interface SerializedMessage {
|
|
|
164
205
|
provider_type?: string;
|
|
165
206
|
usage?: SerializedUsage;
|
|
166
207
|
reasoning?: string;
|
|
208
|
+
/** Anthropic: подпись thinking-блока (миграция `028`). */
|
|
209
|
+
reasoning_signature?: string;
|
|
210
|
+
/** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
|
|
211
|
+
reasoning_redacted?: string[];
|
|
167
212
|
source?: string;
|
|
168
213
|
author?: string;
|
|
169
214
|
agent_role?: string;
|
|
@@ -221,6 +266,22 @@ export declare function deserializeCheckpoint(row: CheckpointRow): Checkpoint;
|
|
|
221
266
|
export declare function stickyNoteRow(sessionId: string, note: StickyNote): Record<string, unknown>;
|
|
222
267
|
/** Строка `sticky_notes` → доменная заметка. */
|
|
223
268
|
export declare function deserializeStickyNote(row: StickyNoteRow): StickyNote;
|
|
269
|
+
/**
|
|
270
|
+
* ADR-114: привязка сессии к worktree из jsonb-колонки `sessions.worktree`.
|
|
271
|
+
*
|
|
272
|
+
* Терпима к отсутствию поля (записи до миграции `023`) и к частичным
|
|
273
|
+
* значениям: привязка без `worktree_id`/`directory` бессмысленна — она
|
|
274
|
+
* игнорируется, сессия работает как прежде.
|
|
275
|
+
*/
|
|
276
|
+
export declare function deserializeSessionWorktree(data: unknown): SessionWorktree | undefined;
|
|
277
|
+
/**
|
|
278
|
+
* Значение `sessions.retry` → доменное состояние ретрая.
|
|
279
|
+
*
|
|
280
|
+
* Форма хранения — snake_case (`stream_id`/`attempt`/`max_retries`/`retry_at`/
|
|
281
|
+
* `error`), как в JSON-файловом backend. Legacy-записи (без поля) и битые
|
|
282
|
+
* значения читаются как «ретрая нет» (`undefined`).
|
|
283
|
+
*/
|
|
284
|
+
export declare function deserializeSessionRetry(data: unknown): SessionRetryState | undefined;
|
|
224
285
|
/**
|
|
225
286
|
* Строка `sessions` + child-данные → доменная сессия: дословный
|
|
226
287
|
* `deserializeSession` файловой реализации (нормализация иконки/цвета,
|
|
@@ -230,8 +291,21 @@ export declare function deserializeStickyNote(row: StickyNoteRow): StickyNote;
|
|
|
230
291
|
export declare function deserializeSession(row: SessionRow, children: SessionChildren): Session;
|
|
231
292
|
/**
|
|
232
293
|
* Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
|
|
233
|
-
*
|
|
234
|
-
*
|
|
235
|
-
*
|
|
294
|
+
* ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
|
|
295
|
+
* сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
|
|
296
|
+
* истории не тянут, нужны recovery/автозапуску). Метаданные
|
|
297
|
+
* (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
|
|
298
|
+
* механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
|
|
236
299
|
*/
|
|
237
300
|
export declare function deserializeSessionLight(row: SessionRow): Session;
|
|
301
|
+
/**
|
|
302
|
+
* Строка `sessions` → доменная сессия **без истории и без очереди**
|
|
303
|
+
* (`SessionRepository.loadLight`, ADR-097): `messages`/`checkpoints` пусты и
|
|
304
|
+
* `pendingMessages`/`steerInbox` **тоже** — контракт порта (`loadLight`
|
|
305
|
+
* возвращает только атрибуты сессии, очередь нужна лишь recovery/автозапуску
|
|
306
|
+
* через `listLight`). Child-таблицы не читаются.
|
|
307
|
+
*
|
|
308
|
+
* Строится поверх `deserializeSessionLight` (та же метапроекция), поэтому
|
|
309
|
+
* остальные поля идентичны `deserializeSession`; отличается только очередь.
|
|
310
|
+
*/
|
|
311
|
+
export declare function deserializeSessionMeta(row: SessionRow): Session;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Отображение строк PostgreSQL ↔ доменных объектов порта `SessionRepository`
|
|
3
|
-
* (
|
|
3
|
+
* (ADR-097, волна 3b).
|
|
4
4
|
*
|
|
5
5
|
* Эталон семантики — файловая реализация (`core/src/storage/file-store.ts`):
|
|
6
6
|
* `serializeSession`/`serializeMessage` и `deserializeSession`/`deserializeMessage`
|
|
@@ -54,18 +54,47 @@ export function toNumberOrUndefined(value) {
|
|
|
54
54
|
return Number.isFinite(num) ? num : undefined;
|
|
55
55
|
}
|
|
56
56
|
function serializePart(part) {
|
|
57
|
-
return {
|
|
57
|
+
return {
|
|
58
|
+
id: part.id,
|
|
59
|
+
type: part.type,
|
|
60
|
+
data: part.data,
|
|
61
|
+
// Anthropic thinking: подпись блока/redacted — аддитивное поле части.
|
|
62
|
+
...(part.metadata ? { metadata: part.metadata } : {}),
|
|
63
|
+
};
|
|
58
64
|
}
|
|
59
65
|
function deserializePart(data) {
|
|
60
|
-
return {
|
|
66
|
+
return {
|
|
67
|
+
id: data.id,
|
|
68
|
+
type: data.type,
|
|
69
|
+
data: data.data,
|
|
70
|
+
...(data.metadata ? { metadata: data.metadata } : {}),
|
|
71
|
+
};
|
|
61
72
|
}
|
|
62
73
|
// ── Сообщения ───────────────────────────────────────────────────────────────
|
|
74
|
+
/**
|
|
75
|
+
* ADR-118 §5: допустимые статусы сообщения-хода. Значение приходит из
|
|
76
|
+
* колонки `status` (text) — неизвестное значение читается как «нет статуса»
|
|
77
|
+
* (fail-soft: мусор в БД не должен ломать чтение сообщения).
|
|
78
|
+
*/
|
|
79
|
+
const MESSAGE_STATUSES = ['streaming', 'completed', 'cancelled', 'error'];
|
|
80
|
+
/** Статус сообщения из колонки `status` (неизвестное значение → `undefined`). */
|
|
81
|
+
function toMessageStatus(value) {
|
|
82
|
+
return typeof value === 'string' && MESSAGE_STATUSES.includes(value)
|
|
83
|
+
? value
|
|
84
|
+
: undefined;
|
|
85
|
+
}
|
|
63
86
|
/** Сообщение → форма хранения (дословно `serializeMessage` файловой реализации). */
|
|
64
87
|
export function serializeMessage(msg) {
|
|
65
88
|
return {
|
|
66
89
|
id: msg.id,
|
|
67
90
|
role: msg.role,
|
|
68
91
|
seq: msg.seq,
|
|
92
|
+
// ADR-118: порядок записи (`ord`) — монотонный, не перенумеровывается;
|
|
93
|
+
// ход (`turn_id`), шаг (`step_index`) и статус — аддитивные поля.
|
|
94
|
+
ord: msg.ord,
|
|
95
|
+
turn_id: msg.turnId,
|
|
96
|
+
step_index: msg.stepIndex,
|
|
97
|
+
status: msg.status,
|
|
69
98
|
origin: msg.origin,
|
|
70
99
|
source_msg_id: msg.sourceMsgId,
|
|
71
100
|
parts: (msg.parts ?? []).map(serializePart),
|
|
@@ -92,6 +121,10 @@ export function serializeMessage(msg) {
|
|
|
92
121
|
}
|
|
93
122
|
: undefined,
|
|
94
123
|
reasoning: msg.reasoning,
|
|
124
|
+
// Anthropic: подпись thinking-блока и opaque `redacted_thinking` —
|
|
125
|
+
// колонки `reasoning_signature`/`reasoning_redacted` (миграция `028`).
|
|
126
|
+
reasoning_signature: msg.reasoningSignature,
|
|
127
|
+
reasoning_redacted: msg.reasoningRedacted,
|
|
95
128
|
source: msg.source,
|
|
96
129
|
author: msg.author,
|
|
97
130
|
agent_role: msg.agentRole,
|
|
@@ -165,12 +198,23 @@ export function deserializeMessage(row) {
|
|
|
165
198
|
});
|
|
166
199
|
}
|
|
167
200
|
}
|
|
168
|
-
|
|
201
|
+
// Reasoning-части — служебные данные протокола (подпись thinking-блока), а не
|
|
202
|
+
// текст сообщения: в `content` они не попадают (legacy-ветка без `parts`
|
|
203
|
+
// сохраняет прежнее восстановление content из reasoning).
|
|
204
|
+
const content = hasParts
|
|
205
|
+
? buildContentFromParts(parts.filter((part) => part.type !== 'reasoning'))
|
|
206
|
+
: buildContentFromParts(parts);
|
|
169
207
|
const usage = row.usage;
|
|
170
208
|
return {
|
|
171
209
|
id: row.id || generateId(),
|
|
172
210
|
role: row.role,
|
|
173
211
|
seq: row.seq ?? 0,
|
|
212
|
+
// ADR-118: порядок записи/ход/шаг/статус — аддитивные поля (legacy-строки
|
|
213
|
+
// без колонок читаются как `undefined`).
|
|
214
|
+
ord: toNumberOrUndefined(row.ord),
|
|
215
|
+
turnId: row.turn_id ?? undefined,
|
|
216
|
+
stepIndex: toNumberOrUndefined(row.step_index),
|
|
217
|
+
status: toMessageStatus(row.status),
|
|
174
218
|
origin: (row.origin || 'local'),
|
|
175
219
|
sourceMsgId: row.source_msg_id ?? undefined,
|
|
176
220
|
parts,
|
|
@@ -197,6 +241,13 @@ export function deserializeMessage(row) {
|
|
|
197
241
|
}
|
|
198
242
|
: undefined,
|
|
199
243
|
reasoning: row.reasoning ?? undefined,
|
|
244
|
+
// Anthropic: подпись thinking-блока и opaque `redacted_thinking` (legacy
|
|
245
|
+
// строки без колонок читаются как `undefined`). `reasoning`-часть выше
|
|
246
|
+
// восстанавливается из `row.reasoning` как и раньше.
|
|
247
|
+
reasoningSignature: row.reasoning_signature ?? undefined,
|
|
248
|
+
reasoningRedacted: Array.isArray(row.reasoning_redacted)
|
|
249
|
+
? row.reasoning_redacted
|
|
250
|
+
: undefined,
|
|
200
251
|
source: (row.source ?? undefined),
|
|
201
252
|
author: row.author ?? undefined,
|
|
202
253
|
agentRole: row.agent_role ?? undefined,
|
|
@@ -225,9 +276,20 @@ export function serializeSession(session) {
|
|
|
225
276
|
branch_point: session.branchPoint ?? null,
|
|
226
277
|
plan_approved: session.planApproved ?? null,
|
|
227
278
|
mode: session.mode ?? null,
|
|
279
|
+
mode_by_principal: session.modeByPrincipal ?? null,
|
|
228
280
|
user_id: session.userId ?? null,
|
|
229
281
|
owner_id: session.ownerId ?? null,
|
|
230
282
|
project_id: session.projectId ?? null,
|
|
283
|
+
// ADR-114: привязка к worktree (объект в snake_case — как в JSON-файле).
|
|
284
|
+
worktree: session.worktree
|
|
285
|
+
? {
|
|
286
|
+
worktree_id: session.worktree.worktreeId,
|
|
287
|
+
project_id: session.worktree.projectId,
|
|
288
|
+
...(session.worktree.repoPath !== undefined ? { repo_path: session.worktree.repoPath } : {}),
|
|
289
|
+
directory: session.worktree.directory,
|
|
290
|
+
branch: session.worktree.branch,
|
|
291
|
+
}
|
|
292
|
+
: null,
|
|
231
293
|
todos: session.todos ?? null,
|
|
232
294
|
prompt_states: session.promptStates ?? null,
|
|
233
295
|
obfuscation_map: session.obfuscationMap ?? null,
|
|
@@ -235,6 +297,7 @@ export function serializeSession(session) {
|
|
|
235
297
|
settings: session.settings ?? {},
|
|
236
298
|
mcp_servers: session.mcpServers ?? null,
|
|
237
299
|
pending_messages: (session.pendingMessages ?? []).map((msg) => serializeMessage(msg)),
|
|
300
|
+
steer_inbox: (session.steerInbox ?? []).map((msg) => serializeMessage(msg)),
|
|
238
301
|
current_stream: session.currentStream
|
|
239
302
|
? {
|
|
240
303
|
stream_id: session.currentStream.streamId,
|
|
@@ -242,6 +305,23 @@ export function serializeSession(session) {
|
|
|
242
305
|
agent_role: session.currentStream.agentRole,
|
|
243
306
|
started_at: session.currentStream.startedAt,
|
|
244
307
|
cancelled: session.currentStream.cancelled,
|
|
308
|
+
// ADR-118 §10: метка хода живого стрима — без неё теряется при
|
|
309
|
+
// перечитывании сессии из БД (`current_stream.turn_id` в DTO).
|
|
310
|
+
turn_id: session.currentStream.turnId ?? null,
|
|
311
|
+
// Владелец маркера хода (процесс инстанса): по нему рестарт отличает
|
|
312
|
+
// живой ход от маркера убитого процесса.
|
|
313
|
+
...(session.currentStream.owner ? { owner: session.currentStream.owner } : {}),
|
|
314
|
+
}
|
|
315
|
+
: null,
|
|
316
|
+
// Персистентное состояние ретрая (переживает reload/restart): snake_case —
|
|
317
|
+
// как в JSON-файловом backend.
|
|
318
|
+
retry: session.retry
|
|
319
|
+
? {
|
|
320
|
+
stream_id: session.retry.streamId,
|
|
321
|
+
attempt: session.retry.attempt,
|
|
322
|
+
max_retries: session.retry.maxRetries,
|
|
323
|
+
retry_at: session.retry.retryAt,
|
|
324
|
+
...(session.retry.error ? { error: session.retry.error } : {}),
|
|
245
325
|
}
|
|
246
326
|
: null,
|
|
247
327
|
summarization_pending: session.summarizationPending ?? false,
|
|
@@ -330,6 +410,52 @@ export function deserializeStickyNote(row) {
|
|
|
330
410
|
disabled: row.disabled,
|
|
331
411
|
};
|
|
332
412
|
}
|
|
413
|
+
/**
|
|
414
|
+
* ADR-114: привязка сессии к worktree из jsonb-колонки `sessions.worktree`.
|
|
415
|
+
*
|
|
416
|
+
* Терпима к отсутствию поля (записи до миграции `023`) и к частичным
|
|
417
|
+
* значениям: привязка без `worktree_id`/`directory` бессмысленна — она
|
|
418
|
+
* игнорируется, сессия работает как прежде.
|
|
419
|
+
*/
|
|
420
|
+
export function deserializeSessionWorktree(data) {
|
|
421
|
+
if (typeof data !== 'object' || data === null)
|
|
422
|
+
return undefined;
|
|
423
|
+
const raw = data;
|
|
424
|
+
const worktreeId = typeof raw.worktree_id === 'string' ? raw.worktree_id : '';
|
|
425
|
+
const directory = typeof raw.directory === 'string' ? raw.directory : '';
|
|
426
|
+
if (!worktreeId || !directory)
|
|
427
|
+
return undefined;
|
|
428
|
+
return {
|
|
429
|
+
worktreeId,
|
|
430
|
+
projectId: typeof raw.project_id === 'string' ? raw.project_id : '',
|
|
431
|
+
...(typeof raw.repo_path === 'string' ? { repoPath: raw.repo_path } : {}),
|
|
432
|
+
directory,
|
|
433
|
+
branch: typeof raw.branch === 'string' ? raw.branch : '',
|
|
434
|
+
};
|
|
435
|
+
}
|
|
436
|
+
/**
|
|
437
|
+
* Значение `sessions.retry` → доменное состояние ретрая.
|
|
438
|
+
*
|
|
439
|
+
* Форма хранения — snake_case (`stream_id`/`attempt`/`max_retries`/`retry_at`/
|
|
440
|
+
* `error`), как в JSON-файловом backend. Legacy-записи (без поля) и битые
|
|
441
|
+
* значения читаются как «ретрая нет» (`undefined`).
|
|
442
|
+
*/
|
|
443
|
+
export function deserializeSessionRetry(data) {
|
|
444
|
+
if (typeof data !== 'object' || data === null)
|
|
445
|
+
return undefined;
|
|
446
|
+
const raw = data;
|
|
447
|
+
const streamId = typeof raw.stream_id === 'string' ? raw.stream_id : '';
|
|
448
|
+
const retryAt = typeof raw.retry_at === 'string' ? raw.retry_at : '';
|
|
449
|
+
if (!streamId || !retryAt)
|
|
450
|
+
return undefined;
|
|
451
|
+
return {
|
|
452
|
+
streamId,
|
|
453
|
+
attempt: typeof raw.attempt === 'number' ? raw.attempt : 0,
|
|
454
|
+
maxRetries: typeof raw.max_retries === 'number' ? raw.max_retries : 0,
|
|
455
|
+
retryAt,
|
|
456
|
+
...(typeof raw.error === 'string' && raw.error ? { error: raw.error } : {}),
|
|
457
|
+
};
|
|
458
|
+
}
|
|
333
459
|
/**
|
|
334
460
|
* Строка `sessions` + child-данные → доменная сессия: дословный
|
|
335
461
|
* `deserializeSession` файловой реализации (нормализация иконки/цвета,
|
|
@@ -338,6 +464,8 @@ export function deserializeStickyNote(row) {
|
|
|
338
464
|
*/
|
|
339
465
|
export function deserializeSession(row, children) {
|
|
340
466
|
const currentStream = row.current_stream;
|
|
467
|
+
// ADR-114: привязка к worktree (legacy-записи без поля → undefined).
|
|
468
|
+
const worktree = deserializeSessionWorktree(row.worktree);
|
|
341
469
|
return {
|
|
342
470
|
id: row.id,
|
|
343
471
|
title: row.title ?? undefined,
|
|
@@ -347,6 +475,10 @@ export function deserializeSession(row, children) {
|
|
|
347
475
|
branchPoint: row.branch_point ?? undefined,
|
|
348
476
|
planApproved: row.plan_approved ?? undefined,
|
|
349
477
|
mode: (row.mode ?? undefined),
|
|
478
|
+
// ADR-106 Ф4 (шаг C): режим по принципалу.
|
|
479
|
+
...(row.mode_by_principal && Object.keys(row.mode_by_principal).length > 0
|
|
480
|
+
? { modeByPrincipal: row.mode_by_principal }
|
|
481
|
+
: {}),
|
|
350
482
|
todos: (row.todos ?? undefined),
|
|
351
483
|
promptStates: (row.prompt_states ?? undefined),
|
|
352
484
|
obfuscationMap: (row.obfuscation_map ?? undefined),
|
|
@@ -354,8 +486,11 @@ export function deserializeSession(row, children) {
|
|
|
354
486
|
userId: row.user_id ?? undefined,
|
|
355
487
|
ownerId: row.owner_id ?? undefined,
|
|
356
488
|
projectId: row.project_id ?? undefined,
|
|
489
|
+
// ADR-114: привязка к worktree (legacy-записи без поля → undefined).
|
|
490
|
+
...(worktree ? { worktree } : {}),
|
|
357
491
|
messages: children.messages.map(deserializeMessage),
|
|
358
492
|
pendingMessages: (row.pending_messages ?? []).map(deserializeMessage),
|
|
493
|
+
steerInbox: (row.steer_inbox ?? []).map(deserializeMessage),
|
|
359
494
|
status: (row.status ?? {}),
|
|
360
495
|
settings: (row.settings ?? {}),
|
|
361
496
|
mcpServers: (row.mcp_servers ?? undefined),
|
|
@@ -369,8 +504,13 @@ export function deserializeSession(row, children) {
|
|
|
369
504
|
agentRole: currentStream.agent_role,
|
|
370
505
|
startedAt: currentStream.started_at,
|
|
371
506
|
cancelled: currentStream.cancelled,
|
|
507
|
+
// ADR-118 §10: метка хода живого стрима (legacy-сессии — нет).
|
|
508
|
+
turnId: currentStream.turn_id ?? undefined,
|
|
509
|
+
owner: currentStream.owner ?? undefined,
|
|
372
510
|
}
|
|
373
511
|
: undefined,
|
|
512
|
+
// Персистентное состояние ретрая (legacy-записи без поля → undefined).
|
|
513
|
+
retry: deserializeSessionRetry(row.retry),
|
|
374
514
|
summarizationPending: row.summarization_pending ?? false,
|
|
375
515
|
canSummarize: row.can_summarize ?? false,
|
|
376
516
|
createdAt: toIso(row.created_at),
|
|
@@ -392,14 +532,31 @@ export function deserializeSession(row, children) {
|
|
|
392
532
|
}
|
|
393
533
|
/**
|
|
394
534
|
* Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
|
|
395
|
-
*
|
|
396
|
-
*
|
|
397
|
-
*
|
|
535
|
+
* ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
|
|
536
|
+
* сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
|
|
537
|
+
* истории не тянут, нужны recovery/автозапуску). Метаданные
|
|
538
|
+
* (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
|
|
539
|
+
* механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
|
|
398
540
|
*/
|
|
399
541
|
export function deserializeSessionLight(row) {
|
|
400
542
|
const session = deserializeSession(row, emptySessionChildren());
|
|
401
543
|
session.messages = [];
|
|
402
|
-
session.pendingMessages = [];
|
|
403
544
|
session.checkpoints = [];
|
|
404
545
|
return session;
|
|
405
546
|
}
|
|
547
|
+
/**
|
|
548
|
+
* Строка `sessions` → доменная сессия **без истории и без очереди**
|
|
549
|
+
* (`SessionRepository.loadLight`, ADR-097): `messages`/`checkpoints` пусты и
|
|
550
|
+
* `pendingMessages`/`steerInbox` **тоже** — контракт порта (`loadLight`
|
|
551
|
+
* возвращает только атрибуты сессии, очередь нужна лишь recovery/автозапуску
|
|
552
|
+
* через `listLight`). Child-таблицы не читаются.
|
|
553
|
+
*
|
|
554
|
+
* Строится поверх `deserializeSessionLight` (та же метапроекция), поэтому
|
|
555
|
+
* остальные поля идентичны `deserializeSession`; отличается только очередь.
|
|
556
|
+
*/
|
|
557
|
+
export function deserializeSessionMeta(row) {
|
|
558
|
+
const session = deserializeSessionLight(row);
|
|
559
|
+
session.pendingMessages = [];
|
|
560
|
+
session.steerInbox = [];
|
|
561
|
+
return session;
|
|
562
|
+
}
|
package/dist/ports/sessions.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Порт `SessionRepository` поверх PostgreSQL (
|
|
2
|
+
* Порт `SessionRepository` поверх PostgreSQL (ADR-097, волна 3b).
|
|
3
3
|
*
|
|
4
4
|
* Группа портов **сессий** PostgreSQL-драйвера: единственная фабрика
|
|
5
5
|
* `buildSessionPorts(deps)` собирает `StorageContext['sessions']`.
|
|
@@ -19,6 +19,14 @@
|
|
|
19
19
|
* (у старых сессий у всех сообщений `seq = 0`) и делает порядок однозначным;
|
|
20
20
|
* домен и так переставляет `seq = i+1` при ветвлении/merge — приведение к
|
|
21
21
|
* позиции смысла не меняет;
|
|
22
|
+
* - ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
|
|
23
|
+
* (выдаётся портом при материализации: `MAX(ord)+1` по сессии, под тем же
|
|
24
|
+
* per-session advisory-локом). Ранее выданные значения **не
|
|
25
|
+
* перенумеровываются**: `save()` сохраняет `ord` сообщения как есть, а
|
|
26
|
+
* `updateMessage` пишет `ord = COALESCE(messages.ord, …)` (уже выданное
|
|
27
|
+
* значение сохраняется; ещё не выданное — legacy-строка — может его
|
|
28
|
+
* получить: так проставляет `ord` миграция данных ядра). Рядом живут
|
|
29
|
+
* аддитивные поля хода/шага/статуса (`turn_id`/`step_index`/`status`);
|
|
22
30
|
* - `id` сообщения **не уникален** в пределах сессии (legacy-дубликаты):
|
|
23
31
|
* PK `messages` — суррогатный `message_uid`, поэтому дубликаты `id`
|
|
24
32
|
* сохраняются без потерь (upsert по `id` их молча схлопывал);
|
|
@@ -28,10 +36,13 @@
|
|
|
28
36
|
* **полную** `Session`; сообщения/child-строки подгружаются **батчем**
|
|
29
37
|
* (`WHERE session_id = ANY($1)`, без N+1); порядок сообщений — по `seq` с
|
|
30
38
|
* тайбрейкером `created_at`, затем `id` (детерминированное чтение);
|
|
31
|
-
* - `listLight` — метаданные без истории (`messages`/`
|
|
32
|
-
*
|
|
39
|
+
* - `listLight` — метаданные без истории (`messages`/`checkpoints` пусты,
|
|
40
|
+
* child-таблицы не читаются; очередь `pendingMessages`/`steerInbox` —
|
|
41
|
+
* jsonb-колонки самой `sessions` — сохраняется): одна выборка из `sessions`
|
|
33
42
|
* тем же `WHERE`/порядком, что у `list`; `loadLight` — та же проекция по
|
|
34
|
-
* одному id (одна выборка по PK)
|
|
43
|
+
* одному id (одна выборка по PK), но **без очереди** (`pendingMessages`/
|
|
44
|
+
* `steerInbox` пусты) — контракт порта: очередь нужна только recovery/
|
|
45
|
+
* автозапуску через `listLight`;
|
|
35
46
|
* - `list`/`listForUser*` сортируют `updated_at DESC`; архивированные сессии
|
|
36
47
|
* **не** отфильтровываются — это ответственность менеджера
|
|
37
48
|
* (`SessionManager.listSessions`, как и у файловой/memory реализаций);
|
|
@@ -50,13 +61,45 @@ import type { SessionFilter, SessionRepository, StorageContext } from '@itphx/sy
|
|
|
50
61
|
import type { PortDeps } from './deps.js';
|
|
51
62
|
/** Часть `StorageContext`, которой владеет группа `sessions`. */
|
|
52
63
|
export type SessionPorts = Pick<StorageContext, 'sessions'>;
|
|
64
|
+
/**
|
|
65
|
+
* Колонки `sessions` (порядок — как в `001_init`).
|
|
66
|
+
*
|
|
67
|
+
* Экспортируется для unit-тестов сериализации (как `MESSAGE_MUTABLE_FIELDS`):
|
|
68
|
+
* тест проверяет, что новая колонка (`worktree`, ADR-114) реально попадает в
|
|
69
|
+
* `INSERT` и читается обратно.
|
|
70
|
+
*/
|
|
71
|
+
export declare const SESSION_FIELDS: readonly ["id", "title", "icon", "color", "session_origin", "parent_id", "branch_point", "plan_approved", "mode", "mode_by_principal", "user_id", "owner_id", "project_id", "worktree", "todos", "prompt_states", "obfuscation_map", "status", "settings", "mcp_servers", "pending_messages", "steer_inbox", "current_stream", "retry", "summarization_pending", "can_summarize", "created_at", "updated_at", "expires_at", "archived_at", "input_tokens", "output_tokens", "total_tokens", "cache_read_tokens", "cache_write_tokens", "reasoning_tokens", "input_cost", "output_cost", "cache_read_cost", "cache_write_cost", "cache_hit_rate"];
|
|
72
|
+
/** jsonb-колонки `sessions` (экспортируется для unit-тестов сериализации). */
|
|
73
|
+
export declare const SESSION_JSON_FIELDS: ReadonlySet<string>;
|
|
74
|
+
/** Колонки `messages` (порядок — как в `001_init`; `028` — reasoning-подпись). */
|
|
75
|
+
export declare const MESSAGE_FIELDS: readonly ["id", "session_id", "seq", "ord", "role", "origin", "source_msg_id", "content", "parts", "tool_calls", "tool_call_id", "usage", "metadata", "prompt_meta", "debug_data", "summary_of", "model", "provider", "provider_type", "reasoning", "reasoning_signature", "reasoning_redacted", "source", "author", "agent_role", "qa_pass", "qa_reason", "disabled", "pinned", "hidden", "ephemeral", "turn_id", "step_index", "status", "created_at"];
|
|
76
|
+
export declare const MESSAGE_JSON_FIELDS: ReadonlySet<string>;
|
|
53
77
|
/**
|
|
54
78
|
* Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
|
|
55
79
|
* суррогатный `message_uid` (PK), доменный `id`, `session_id`, позиционный
|
|
56
80
|
* `seq` и `created_at`: они сохраняются от исходной строки (цель ищется по
|
|
57
81
|
* `seq`, fallback по `id`).
|
|
82
|
+
*
|
|
83
|
+
* ADR-118: `ord` — **не** перенумеровывается обновлением (он иммутабелен
|
|
84
|
+
* после выдачи), поэтому в общий список изменяемых колонок он не входит:
|
|
85
|
+
* `updateMessage` пишет его отдельной фразой `COALESCE(messages.ord, …)` —
|
|
86
|
+
* уже выданное значение сохраняется, а ещё не выданное (legacy-строка) может
|
|
87
|
+
* получить его (так проставляет `ord` миграция данных ядра).
|
|
88
|
+
*/
|
|
89
|
+
export declare const MESSAGE_MUTABLE_FIELDS: ("origin" | "author" | "status" | "source" | "usage" | "model" | "provider" | "metadata" | "ephemeral" | "disabled" | "content" | "role" | "reasoning" | "pinned" | "hidden" | "agent_role" | "turn_id" | "source_msg_id" | "parts" | "tool_calls" | "tool_call_id" | "prompt_meta" | "debug_data" | "summary_of" | "provider_type" | "reasoning_signature" | "reasoning_redacted" | "qa_pass" | "qa_reason" | "step_index")[];
|
|
90
|
+
/**
|
|
91
|
+
* ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
|
|
92
|
+
* сессии (выдаётся при материализации, ранее выданные значения не
|
|
93
|
+
* перенумеровываются).
|
|
94
|
+
*
|
|
95
|
+
* Правило выдачи: уже проставленный вызывателем `ord` **не перетирается**
|
|
96
|
+
* (иначе порядок записей ездил бы); иначе берётся `max(ord)+1` по сессии —
|
|
97
|
+
* значение вычислено в той же транзакции (per-session advisory-лок), поэтому
|
|
98
|
+
* два параллельных append'а не получат один `ord`.
|
|
99
|
+
*
|
|
100
|
+
* Экспортируется для unit-тестов (живая БД не нужна).
|
|
58
101
|
*/
|
|
59
|
-
export declare
|
|
102
|
+
export declare function resolveOrd(requested: unknown, nextOrd: number): number;
|
|
60
103
|
/** Значение для jsonb-колонки: нативный объект/массив → JSON-строка (NUL — вычищены). */
|
|
61
104
|
export declare function jsonParam(value: unknown): string | null;
|
|
62
105
|
/**
|
|
@@ -80,6 +123,12 @@ export declare class PostgresSessionRepository implements SessionRepository {
|
|
|
80
123
|
* транзакция + per-session advisory-лок (как у `save`), `seq = MAX(seq)+1`
|
|
81
124
|
* вычисляется в той же транзакции, `INSERT` одной строки, обновление
|
|
82
125
|
* `sessions.updated_at`. Остальная история не перезаписывается.
|
|
126
|
+
*
|
|
127
|
+
* ADR-118 §2: `ord` — **монотонный** счётчик сессии (`MAX(ord)+1` по
|
|
128
|
+
* сессии), выдаётся в момент материализации записи в историю; ранее
|
|
129
|
+
* выданные значения не перенумеровываются. Если вызывающий уже проставил
|
|
130
|
+
* `ord` (например, перенос записи), его значение сохраняется — порт не
|
|
131
|
+
* перетирает выданный порядок.
|
|
83
132
|
*/
|
|
84
133
|
appendMessage(sessionId: string, message: Message): Promise<Message | null>;
|
|
85
134
|
/**
|
|
@@ -87,11 +136,16 @@ export declare class PostgresSessionRepository implements SessionRepository {
|
|
|
87
136
|
* транзакция + per-session advisory-лок; цель — по `seq` (первая по
|
|
88
137
|
* `seq, created_at, id`), fallback по `id`. `message_uid`/`id`/`seq`/
|
|
89
138
|
* `created_at` исходной строки не меняются, `sessions.updated_at` обновляется.
|
|
139
|
+
*
|
|
140
|
+
* ADR-118: `ord` не перенумеровывается — уже выданное значение сохраняется
|
|
141
|
+
* (`COALESCE(messages.ord, …)`), а ещё не выданное (legacy-строка без
|
|
142
|
+
* `ord`) может быть проставлено (миграция данных ядра).
|
|
90
143
|
*/
|
|
91
144
|
updateMessage(sessionId: string, message: Message): Promise<Message | null>;
|
|
92
145
|
/**
|
|
93
|
-
* Метаданные сессии без истории (`SessionRepository.loadLight`):
|
|
94
|
-
* выборка по PK, child-таблицы не
|
|
146
|
+
* Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
|
|
147
|
+
* одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
|
|
148
|
+
* пусты (очередь отдаёт только `listLight` — recovery/автозапуску).
|
|
95
149
|
*/
|
|
96
150
|
loadLight(sessionId: string): Promise<Session | null>;
|
|
97
151
|
delete(sessionId: string): Promise<void>;
|
|
@@ -124,7 +178,7 @@ export declare class PostgresSessionRepository implements SessionRepository {
|
|
|
124
178
|
* первая по `seq, created_at, id`), затем fallback по доменному `id`.
|
|
125
179
|
*/
|
|
126
180
|
private _findMessageUid;
|
|
127
|
-
/**
|
|
181
|
+
/** ADR-097: per-session сериализация записи — транзакционный advisory-лок. */
|
|
128
182
|
private _lockSession;
|
|
129
183
|
/** `addReference`/`removeReference` отсутствующей сессии → ошибка (как в file/memory). */
|
|
130
184
|
private _assertSessionExists;
|