@itphx/synth-storage-postgres 0.12.4 → 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/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.js +6 -0
- package/dist/ports/context-files.d.ts +2 -0
- package/dist/ports/context-files.js +6 -0
- package/dist/ports/events-scheduler.js +19 -11
- package/dist/ports/principals-defaults.js +20 -0
- package/dist/ports/principals-projects.js +80 -48
- package/dist/ports/principals-settings.js +36 -0
- package/dist/ports/sessions-mapping.d.ts +62 -5
- package/dist/ports/sessions-mapping.js +120 -7
- package/dist/ports/sessions.d.ts +51 -7
- package/dist/ports/sessions.js +76 -15
- package/package.json +4 -4
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 028_message_reasoning_signature — подпись thinking-блока Anthropic
|
|
3
|
+
* в истории сообщений.
|
|
4
|
+
*
|
|
5
|
+
* `reasoning_signature text` — подпись блока `thinking` (`signature`), пустая
|
|
6
|
+
* строка валидна; `reasoning_redacted jsonb` — массив opaque-данных блоков
|
|
7
|
+
* `redacted_thinking` (реплеятся в историю verbatim). Без этих полей
|
|
8
|
+
* tool-loop при включённом thinking отвергается API («thinking не возвращён в
|
|
9
|
+
* историю»): PG-порт их не писал и не читал, и подпись терялась после рестарта.
|
|
10
|
+
*
|
|
11
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
12
|
+
*/
|
|
13
|
+
export declare const MIGRATION_028_MESSAGE_REASONING_SIGNATURE = "\n-- Anthropic: \u043F\u043E\u0434\u043F\u0438\u0441\u044C thinking-\u0431\u043B\u043E\u043A\u0430 \u0438 opaque-\u0434\u0430\u043D\u043D\u044B\u0435 redacted-\u0431\u043B\u043E\u043A\u043E\u0432 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F.\nALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_signature text;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_redacted jsonb;\nCOMMENT ON COLUMN messages.reasoning_signature IS 'Anthropic: \u043F\u043E\u0434\u043F\u0438\u0441\u044C thinking-\u0431\u043B\u043E\u043A\u0430 (\u043F\u0443\u0441\u0442\u0430\u044F \u0441\u0442\u0440\u043E\u043A\u0430 \u0432\u0430\u043B\u0438\u0434\u043D\u0430)';\nCOMMENT ON COLUMN messages.reasoning_redacted IS 'Anthropic: opaque-\u0434\u0430\u043D\u043D\u044B\u0435 \u0431\u043B\u043E\u043A\u043E\u0432 redacted_thinking (verbatim data)';\n";
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 028_message_reasoning_signature — подпись thinking-блока Anthropic
|
|
3
|
+
* в истории сообщений.
|
|
4
|
+
*
|
|
5
|
+
* `reasoning_signature text` — подпись блока `thinking` (`signature`), пустая
|
|
6
|
+
* строка валидна; `reasoning_redacted jsonb` — массив opaque-данных блоков
|
|
7
|
+
* `redacted_thinking` (реплеятся в историю verbatim). Без этих полей
|
|
8
|
+
* tool-loop при включённом thinking отвергается API («thinking не возвращён в
|
|
9
|
+
* историю»): PG-порт их не писал и не читал, и подпись терялась после рестарта.
|
|
10
|
+
*
|
|
11
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
12
|
+
*/
|
|
13
|
+
export const MIGRATION_028_MESSAGE_REASONING_SIGNATURE = `
|
|
14
|
+
-- Anthropic: подпись thinking-блока и opaque-данные redacted-блоков сообщения.
|
|
15
|
+
ALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_signature text;
|
|
16
|
+
ALTER TABLE messages ADD COLUMN IF NOT EXISTS reasoning_redacted jsonb;
|
|
17
|
+
COMMENT ON COLUMN messages.reasoning_signature IS 'Anthropic: подпись thinking-блока (пустая строка валидна)';
|
|
18
|
+
COMMENT ON COLUMN messages.reasoning_redacted IS 'Anthropic: opaque-данные блоков redacted_thinking (verbatim data)';
|
|
19
|
+
`;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 029_message_stream_v2 — модель «ход как последовательность шагов»
|
|
3
|
+
* (ADR-118).
|
|
4
|
+
*
|
|
5
|
+
* В таблице `messages` появляются четыре аддитивные колонки:
|
|
6
|
+
* - `ord integer` — **монотонный** счётчик порядка записи в историю
|
|
7
|
+
* сессии (выдаётся при материализации, никогда не перенумеровывается);
|
|
8
|
+
* - `turn_id text` — идентификатор хода (`Turn`);
|
|
9
|
+
* - `step_index integer` — индекс шага внутри хода (0-based; шаг = один
|
|
10
|
+
* вызов LLM = одно assistant-сообщение);
|
|
11
|
+
* - `status text` — статус сообщения-хода
|
|
12
|
+
* (`streaming`/`completed`/`cancelled`/`error`).
|
|
13
|
+
*
|
|
14
|
+
* `seq` **не трогается**: он остаётся позиционным, а `UNIQUE (session_id, seq)`
|
|
15
|
+
* сохраняется (ADR-118 §2 «Альтернативы (а)»).
|
|
16
|
+
*
|
|
17
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
18
|
+
* Данные (проставка `ord`/`turn_id`/`step_index` старым сообщениям) миграцией
|
|
19
|
+
* **не** делается: она построчная и живёт в ядре
|
|
20
|
+
* (`packages/core/src/storage/migrations.ts`, ADR-118 §9).
|
|
21
|
+
*/
|
|
22
|
+
export declare const MIGRATION_029_MESSAGE_STREAM_V2 = "\n-- ADR-118: \u043F\u043E\u0440\u044F\u0434\u043E\u043A \u0437\u0430\u043F\u0438\u0441\u0438 (ord), \u0445\u043E\u0434 (turn_id), \u0448\u0430\u0433 (step_index), \u0441\u0442\u0430\u0442\u0443\u0441.\nALTER TABLE messages ADD COLUMN IF NOT EXISTS ord integer;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS turn_id text;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS step_index integer;\nALTER TABLE messages ADD COLUMN IF NOT EXISTS status text;\nCREATE INDEX IF NOT EXISTS messages_session_ord_idx ON messages (session_id, ord);\nCOMMENT ON COLUMN messages.ord IS 'ADR-118: \u043C\u043E\u043D\u043E\u0442\u043E\u043D\u043D\u044B\u0439 \u0441\u0447\u0451\u0442\u0447\u0438\u043A \u043F\u043E\u0440\u044F\u0434\u043A\u0430 \u0437\u0430\u043F\u0438\u0441\u0438 \u0432 \u0438\u0441\u0442\u043E\u0440\u0438\u044E \u0441\u0435\u0441\u0441\u0438\u0438 (\u043D\u0435 \u043F\u0435\u0440\u0435\u043D\u0443\u043C\u0435\u0440\u043E\u0432\u044B\u0432\u0430\u0435\u0442\u0441\u044F)';\nCOMMENT ON COLUMN messages.turn_id IS 'ADR-118: \u0438\u0434\u0435\u043D\u0442\u0438\u0444\u0438\u043A\u0430\u0442\u043E\u0440 \u0445\u043E\u0434\u0430 (Turn)';\nCOMMENT ON COLUMN messages.step_index IS 'ADR-118: \u0438\u043D\u0434\u0435\u043A\u0441 \u0448\u0430\u0433\u0430 \u0432\u043D\u0443\u0442\u0440\u0438 \u0445\u043E\u0434\u0430 (0-based)';\nCOMMENT ON COLUMN messages.status IS 'ADR-118: \u0441\u0442\u0430\u0442\u0443\u0441 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F (streaming/completed/cancelled/error)';\n";
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 029_message_stream_v2 — модель «ход как последовательность шагов»
|
|
3
|
+
* (ADR-118).
|
|
4
|
+
*
|
|
5
|
+
* В таблице `messages` появляются четыре аддитивные колонки:
|
|
6
|
+
* - `ord integer` — **монотонный** счётчик порядка записи в историю
|
|
7
|
+
* сессии (выдаётся при материализации, никогда не перенумеровывается);
|
|
8
|
+
* - `turn_id text` — идентификатор хода (`Turn`);
|
|
9
|
+
* - `step_index integer` — индекс шага внутри хода (0-based; шаг = один
|
|
10
|
+
* вызов LLM = одно assistant-сообщение);
|
|
11
|
+
* - `status text` — статус сообщения-хода
|
|
12
|
+
* (`streaming`/`completed`/`cancelled`/`error`).
|
|
13
|
+
*
|
|
14
|
+
* `seq` **не трогается**: он остаётся позиционным, а `UNIQUE (session_id, seq)`
|
|
15
|
+
* сохраняется (ADR-118 §2 «Альтернативы (а)»).
|
|
16
|
+
*
|
|
17
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
18
|
+
* Данные (проставка `ord`/`turn_id`/`step_index` старым сообщениям) миграцией
|
|
19
|
+
* **не** делается: она построчная и живёт в ядре
|
|
20
|
+
* (`packages/core/src/storage/migrations.ts`, ADR-118 §9).
|
|
21
|
+
*/
|
|
22
|
+
export const MIGRATION_029_MESSAGE_STREAM_V2 = `
|
|
23
|
+
-- ADR-118: порядок записи (ord), ход (turn_id), шаг (step_index), статус.
|
|
24
|
+
ALTER TABLE messages ADD COLUMN IF NOT EXISTS ord integer;
|
|
25
|
+
ALTER TABLE messages ADD COLUMN IF NOT EXISTS turn_id text;
|
|
26
|
+
ALTER TABLE messages ADD COLUMN IF NOT EXISTS step_index integer;
|
|
27
|
+
ALTER TABLE messages ADD COLUMN IF NOT EXISTS status text;
|
|
28
|
+
CREATE INDEX IF NOT EXISTS messages_session_ord_idx ON messages (session_id, ord);
|
|
29
|
+
COMMENT ON COLUMN messages.ord IS 'ADR-118: монотонный счётчик порядка записи в историю сессии (не перенумеровывается)';
|
|
30
|
+
COMMENT ON COLUMN messages.turn_id IS 'ADR-118: идентификатор хода (Turn)';
|
|
31
|
+
COMMENT ON COLUMN messages.step_index IS 'ADR-118: индекс шага внутри хода (0-based)';
|
|
32
|
+
COMMENT ON COLUMN messages.status IS 'ADR-118: статус сообщения (streaming/completed/cancelled/error)';
|
|
33
|
+
`;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 030_session_retry — персистентное состояние ретрая сессии.
|
|
3
|
+
*
|
|
4
|
+
* `retry jsonb` — снимок состояния повторной попытки LLM-вызова
|
|
5
|
+
* (`stream_id`/`attempt`/`max_retries`/`retry_at`/`error`). Поле появилось в
|
|
6
|
+
* контракте `Session.retry` после миграции `029`, поэтому колонки в таблице
|
|
7
|
+
* `sessions` не было — PG-порт её не писал и не читал, и после reload/restart
|
|
8
|
+
* клиент не видел, что ход повторяется (в отличие от файлового backend).
|
|
9
|
+
*
|
|
10
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
11
|
+
*/
|
|
12
|
+
export declare const MIGRATION_030_SESSION_RETRY = "\n-- \u0421\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0435 \u0440\u0435\u0442\u0440\u0430\u044F \u0441\u0435\u0441\u0441\u0438\u0438 (\u043F\u0435\u0440\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0435): stream_id/attempt/max_retries/retry_at/error.\nALTER TABLE sessions ADD COLUMN IF NOT EXISTS retry jsonb;\nCOMMENT ON COLUMN sessions.retry IS '\u041F\u0435\u0440\u0441\u0438\u0441\u0442\u0435\u043D\u0442\u043D\u043E\u0435 \u0441\u043E\u0441\u0442\u043E\u044F\u043D\u0438\u0435 \u0440\u0435\u0442\u0440\u0430\u044F \u0441\u0435\u0441\u0441\u0438\u0438: stream_id/attempt/max_retries/retry_at/error';\n";
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Миграция 030_session_retry — персистентное состояние ретрая сессии.
|
|
3
|
+
*
|
|
4
|
+
* `retry jsonb` — снимок состояния повторной попытки LLM-вызова
|
|
5
|
+
* (`stream_id`/`attempt`/`max_retries`/`retry_at`/`error`). Поле появилось в
|
|
6
|
+
* контракте `Session.retry` после миграции `029`, поэтому колонки в таблице
|
|
7
|
+
* `sessions` не было — PG-порт её не писал и не читал, и после reload/restart
|
|
8
|
+
* клиент не видел, что ход повторяется (в отличие от файлового backend).
|
|
9
|
+
*
|
|
10
|
+
* Миграция идемпотентна (`IF NOT EXISTS`) — повторное применение безопасно.
|
|
11
|
+
*/
|
|
12
|
+
export const MIGRATION_030_SESSION_RETRY = `
|
|
13
|
+
-- Состояние ретрая сессии (персистентное): stream_id/attempt/max_retries/retry_at/error.
|
|
14
|
+
ALTER TABLE sessions ADD COLUMN IF NOT EXISTS retry jsonb;
|
|
15
|
+
COMMENT ON COLUMN sessions.retry IS 'Персистентное состояние ретрая сессии: stream_id/attempt/max_retries/retry_at/error';
|
|
16
|
+
`;
|
package/dist/migrations/index.js
CHANGED
|
@@ -35,6 +35,9 @@ import { MIGRATION_024_BLOB_REFS } from './024-blob-refs.js';
|
|
|
35
35
|
import { MIGRATION_025_PACKS_PIPELINES } from './025-packs-pipelines.js';
|
|
36
36
|
import { MIGRATION_026_INSTANCE_SKILLS } from './026-instance-skills.js';
|
|
37
37
|
import { MIGRATION_027_CONTEXT_FILES } from './027-context-files.js';
|
|
38
|
+
import { MIGRATION_028_MESSAGE_REASONING_SIGNATURE } from './028-message-reasoning-signature.js';
|
|
39
|
+
import { MIGRATION_029_MESSAGE_STREAM_V2 } from './029-message-stream-v2.js';
|
|
40
|
+
import { MIGRATION_030_SESSION_RETRY } from './030-session-retry.js';
|
|
38
41
|
/** Полный набор миграций драйвера (по возрастанию версии). */
|
|
39
42
|
export const MIGRATIONS = [
|
|
40
43
|
{ version: 1, id: '001_init', sql: MIGRATION_001_INIT },
|
|
@@ -64,6 +67,9 @@ export const MIGRATIONS = [
|
|
|
64
67
|
{ version: 25, id: '025_packs_pipelines', sql: MIGRATION_025_PACKS_PIPELINES },
|
|
65
68
|
{ version: 26, id: '026_instance_skills', sql: MIGRATION_026_INSTANCE_SKILLS },
|
|
66
69
|
{ version: 27, id: '027_context_files', sql: MIGRATION_027_CONTEXT_FILES },
|
|
70
|
+
{ version: 28, id: '028_message_reasoning_signature', sql: MIGRATION_028_MESSAGE_REASONING_SIGNATURE },
|
|
71
|
+
{ version: 29, id: '029_message_stream_v2', sql: MIGRATION_029_MESSAGE_STREAM_V2 },
|
|
72
|
+
{ version: 30, id: '030_session_retry', sql: MIGRATION_030_SESSION_RETRY },
|
|
67
73
|
];
|
|
68
74
|
/** Последняя (ожидаемая) версия схемы. */
|
|
69
75
|
export function latestSchemaVersion(migrations = MIGRATIONS) {
|
|
@@ -97,8 +97,10 @@ export declare class PgContextFileRepository implements ContextFileRepository, C
|
|
|
97
97
|
getParticipantsNotice(language?: string): string;
|
|
98
98
|
getSchedulerNotice(language?: string): string;
|
|
99
99
|
getSchedulerTurnNotice(language?: string): string;
|
|
100
|
+
getSubagentNotice(language?: string): string;
|
|
100
101
|
getMaxStepsPrompt(language?: string): string;
|
|
101
102
|
getSummarizerPrompt(language?: string): string;
|
|
103
|
+
getCompactorPrompt(language?: string): string;
|
|
102
104
|
getUserContextTemplate(language?: string): string;
|
|
103
105
|
getCompressedDialogTemplate(language?: string): string;
|
|
104
106
|
getAttachmentsDroppedTemplate(language?: string): string;
|
|
@@ -108,12 +108,18 @@ export class PgContextFileRepository {
|
|
|
108
108
|
getSchedulerTurnNotice(language) {
|
|
109
109
|
return this._config.getSchedulerTurnNotice(language);
|
|
110
110
|
}
|
|
111
|
+
getSubagentNotice(language) {
|
|
112
|
+
return this._config.getSubagentNotice(language);
|
|
113
|
+
}
|
|
111
114
|
getMaxStepsPrompt(language) {
|
|
112
115
|
return this._config.getMaxStepsPrompt(language);
|
|
113
116
|
}
|
|
114
117
|
getSummarizerPrompt(language) {
|
|
115
118
|
return this._config.getSummarizerPrompt(language);
|
|
116
119
|
}
|
|
120
|
+
getCompactorPrompt(language) {
|
|
121
|
+
return this._config.getCompactorPrompt(language);
|
|
122
|
+
}
|
|
117
123
|
getUserContextTemplate(language) {
|
|
118
124
|
return this._config.getUserContextTemplate(language);
|
|
119
125
|
}
|
|
@@ -91,32 +91,40 @@ export class PgScheduleRepository {
|
|
|
91
91
|
params.push(patch.enabled);
|
|
92
92
|
sets.push(`enabled = $${params.length}`);
|
|
93
93
|
}
|
|
94
|
-
|
|
95
|
-
|
|
94
|
+
// Пара триггеров заменяется целиком (контракт порта): собственный ключ
|
|
95
|
+
// `cron`/`every` переписывает **обе** колонки, отсутствующая/`undefined`
|
|
96
|
+
// уходит в NULL. Иначе очистить прежний триггер было нельзя, а запись с
|
|
97
|
+
// обоими полями не лечилась.
|
|
98
|
+
if (Object.hasOwn(patch, 'cron') || Object.hasOwn(patch, 'every')) {
|
|
99
|
+
params.push(patch.cron ?? null);
|
|
96
100
|
sets.push(`cron = $${params.length}`);
|
|
97
|
-
|
|
98
|
-
if (patch.every !== undefined) {
|
|
99
|
-
params.push(patch.every);
|
|
101
|
+
params.push(patch.every ?? null);
|
|
100
102
|
sets.push(`every = $${params.length}`);
|
|
101
103
|
}
|
|
102
104
|
if (patch.target !== undefined) {
|
|
103
105
|
params.push(jsonbParam(patch.target));
|
|
104
106
|
sets.push(`target = $${params.length}::jsonb`);
|
|
105
107
|
}
|
|
106
|
-
|
|
107
|
-
|
|
108
|
+
// Nullable-поля — own-property семантика: собственный ключ со значением
|
|
109
|
+
// `undefined` очищает колонку (`NULL`), отсутствие ключа — не трогает.
|
|
110
|
+
if (Object.hasOwn(patch, 'prompt')) {
|
|
111
|
+
params.push(patch.prompt ?? null);
|
|
108
112
|
sets.push(`prompt = $${params.length}`);
|
|
109
113
|
}
|
|
110
|
-
if (patch
|
|
111
|
-
params.push(jsonbParam(patch.payload));
|
|
114
|
+
if (Object.hasOwn(patch, 'payload')) {
|
|
115
|
+
params.push(patch.payload !== undefined ? jsonbParam(patch.payload) : null);
|
|
112
116
|
sets.push(`payload = $${params.length}::jsonb`);
|
|
113
117
|
}
|
|
118
|
+
// Владелец — исключение: это атрибуция/область доступа расписания
|
|
119
|
+
// (`ownerId === userId`), а не пользовательское содержимое. Патч с
|
|
120
|
+
// `ownerId: undefined` считается «не менять», иначе владельца можно было
|
|
121
|
+
// бы случайно потерять и расписание выпало бы из области «свои + проект».
|
|
114
122
|
if (patch.ownerId !== undefined) {
|
|
115
123
|
params.push(patch.ownerId);
|
|
116
124
|
sets.push(`owner_id = $${params.length}`);
|
|
117
125
|
}
|
|
118
|
-
if (patch
|
|
119
|
-
params.push(patch.catchUp);
|
|
126
|
+
if (Object.hasOwn(patch, 'catchUp')) {
|
|
127
|
+
params.push(patch.catchUp ?? null);
|
|
120
128
|
sets.push(`catch_up = $${params.length}`);
|
|
121
129
|
}
|
|
122
130
|
params.push(id);
|
|
@@ -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
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
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) {
|
|
@@ -291,5 +291,41 @@ export function createPrincipalSettingsPort(conn) {
|
|
|
291
291
|
async clearAttachments() {
|
|
292
292
|
await deleteSetting(conn, 'attachments');
|
|
293
293
|
},
|
|
294
|
+
async getContextWindowPolicy() {
|
|
295
|
+
return readSetting(conn, 'contextWindowPolicy');
|
|
296
|
+
},
|
|
297
|
+
async setContextWindowPolicy(policy) {
|
|
298
|
+
await writeSetting(conn, 'contextWindowPolicy', policy);
|
|
299
|
+
},
|
|
300
|
+
async clearContextWindowPolicy() {
|
|
301
|
+
await deleteSetting(conn, 'contextWindowPolicy');
|
|
302
|
+
},
|
|
303
|
+
async getSubagentMaxInputTokens() {
|
|
304
|
+
return readSetting(conn, 'subagentMaxInputTokens');
|
|
305
|
+
},
|
|
306
|
+
async setSubagentMaxInputTokens(value) {
|
|
307
|
+
await writeSetting(conn, 'subagentMaxInputTokens', value);
|
|
308
|
+
},
|
|
309
|
+
async clearSubagentMaxInputTokens() {
|
|
310
|
+
await deleteSetting(conn, 'subagentMaxInputTokens');
|
|
311
|
+
},
|
|
312
|
+
async getContextDefaults() {
|
|
313
|
+
return readSetting(conn, 'contextDefaults');
|
|
314
|
+
},
|
|
315
|
+
async setContextDefaults(defaults) {
|
|
316
|
+
await writeSetting(conn, 'contextDefaults', defaults);
|
|
317
|
+
},
|
|
318
|
+
async clearContextDefaults() {
|
|
319
|
+
await deleteSetting(conn, 'contextDefaults');
|
|
320
|
+
},
|
|
321
|
+
async getStickyNotesLimits() {
|
|
322
|
+
return readSetting(conn, 'stickyNotesLimits');
|
|
323
|
+
},
|
|
324
|
+
async setStickyNotesLimits(limits) {
|
|
325
|
+
await writeSetting(conn, 'stickyNotesLimits', limits);
|
|
326
|
+
},
|
|
327
|
+
async clearStickyNotesLimits() {
|
|
328
|
+
await deleteSetting(conn, 'stickyNotesLimits');
|
|
329
|
+
},
|
|
294
330
|
};
|
|
295
331
|
}
|
|
@@ -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;
|
|
@@ -50,6 +50,11 @@ export interface SessionRow {
|
|
|
50
50
|
/** ADR-104: очередь инъекций (steering) — отдельно от `pending_messages`. */
|
|
51
51
|
steer_inbox: unknown;
|
|
52
52
|
current_stream: unknown;
|
|
53
|
+
/**
|
|
54
|
+
* Персистентное состояние ретрая сессии (jsonb, миграция `030`). В записях,
|
|
55
|
+
* созданных до миграции, поля нет — чтение даёт `undefined`.
|
|
56
|
+
*/
|
|
57
|
+
retry?: unknown;
|
|
53
58
|
summarization_pending: boolean;
|
|
54
59
|
can_summarize: boolean;
|
|
55
60
|
created_at: string | Date;
|
|
@@ -73,6 +78,17 @@ export interface MessageRow {
|
|
|
73
78
|
id: string;
|
|
74
79
|
session_id?: string;
|
|
75
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;
|
|
76
92
|
role: string;
|
|
77
93
|
origin: string;
|
|
78
94
|
source_msg_id?: string | null;
|
|
@@ -89,6 +105,10 @@ export interface MessageRow {
|
|
|
89
105
|
provider?: string | null;
|
|
90
106
|
provider_type?: string | null;
|
|
91
107
|
reasoning?: string | null;
|
|
108
|
+
/** Anthropic: подпись thinking-блока (миграция `028`). */
|
|
109
|
+
reasoning_signature?: string | null;
|
|
110
|
+
/** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
|
|
111
|
+
reasoning_redacted?: unknown;
|
|
92
112
|
source?: string | null;
|
|
93
113
|
author?: string | null;
|
|
94
114
|
agent_role?: string | null;
|
|
@@ -136,11 +156,13 @@ export interface SessionChildren {
|
|
|
136
156
|
}
|
|
137
157
|
/** Пустой набор child-данных (сессия без сообщений/ссылок/чекпоинтов). */
|
|
138
158
|
export declare function emptySessionChildren(): SessionChildren;
|
|
139
|
-
/** Часть сообщения в форме хранения (`{id, type, data}`). */
|
|
159
|
+
/** Часть сообщения в форме хранения (`{id, type, data}` + аддитивные `metadata`). */
|
|
140
160
|
export interface SerializedPart {
|
|
141
161
|
id: string;
|
|
142
162
|
type: string;
|
|
143
163
|
data: unknown;
|
|
164
|
+
/** Anthropic thinking: подпись/redacted части (аддитивное поле). */
|
|
165
|
+
metadata?: Part['metadata'];
|
|
144
166
|
}
|
|
145
167
|
/** Usage сообщения в форме хранения (snake_case — как в файловом backend). */
|
|
146
168
|
export interface SerializedUsage {
|
|
@@ -156,6 +178,16 @@ export interface SerializedMessage {
|
|
|
156
178
|
id: string;
|
|
157
179
|
role: string;
|
|
158
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;
|
|
159
191
|
origin: string;
|
|
160
192
|
source_msg_id?: string;
|
|
161
193
|
parts: SerializedPart[];
|
|
@@ -173,6 +205,10 @@ export interface SerializedMessage {
|
|
|
173
205
|
provider_type?: string;
|
|
174
206
|
usage?: SerializedUsage;
|
|
175
207
|
reasoning?: string;
|
|
208
|
+
/** Anthropic: подпись thinking-блока (миграция `028`). */
|
|
209
|
+
reasoning_signature?: string;
|
|
210
|
+
/** Anthropic: opaque-данные `redacted_thinking` (jsonb, миграция `028`). */
|
|
211
|
+
reasoning_redacted?: string[];
|
|
176
212
|
source?: string;
|
|
177
213
|
author?: string;
|
|
178
214
|
agent_role?: string;
|
|
@@ -238,6 +274,14 @@ export declare function deserializeStickyNote(row: StickyNoteRow): StickyNote;
|
|
|
238
274
|
* игнорируется, сессия работает как прежде.
|
|
239
275
|
*/
|
|
240
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;
|
|
241
285
|
/**
|
|
242
286
|
* Строка `sessions` + child-данные → доменная сессия: дословный
|
|
243
287
|
* `deserializeSession` файловой реализации (нормализация иконки/цвета,
|
|
@@ -247,8 +291,21 @@ export declare function deserializeSessionWorktree(data: unknown): SessionWorktr
|
|
|
247
291
|
export declare function deserializeSession(row: SessionRow, children: SessionChildren): Session;
|
|
248
292
|
/**
|
|
249
293
|
* Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
|
|
250
|
-
* ADR-097): `messages`/`
|
|
251
|
-
*
|
|
252
|
-
*
|
|
294
|
+
* ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
|
|
295
|
+
* сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
|
|
296
|
+
* истории не тянут, нужны recovery/автозапуску). Метаданные
|
|
297
|
+
* (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
|
|
298
|
+
* механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
|
|
253
299
|
*/
|
|
254
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;
|
|
@@ -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,
|
|
@@ -254,6 +305,23 @@ export function serializeSession(session) {
|
|
|
254
305
|
agent_role: session.currentStream.agentRole,
|
|
255
306
|
started_at: session.currentStream.startedAt,
|
|
256
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 } : {}),
|
|
257
325
|
}
|
|
258
326
|
: null,
|
|
259
327
|
summarization_pending: session.summarizationPending ?? false,
|
|
@@ -365,6 +433,29 @@ export function deserializeSessionWorktree(data) {
|
|
|
365
433
|
branch: typeof raw.branch === 'string' ? raw.branch : '',
|
|
366
434
|
};
|
|
367
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
|
+
}
|
|
368
459
|
/**
|
|
369
460
|
* Строка `sessions` + child-данные → доменная сессия: дословный
|
|
370
461
|
* `deserializeSession` файловой реализации (нормализация иконки/цвета,
|
|
@@ -413,8 +504,13 @@ export function deserializeSession(row, children) {
|
|
|
413
504
|
agentRole: currentStream.agent_role,
|
|
414
505
|
startedAt: currentStream.started_at,
|
|
415
506
|
cancelled: currentStream.cancelled,
|
|
507
|
+
// ADR-118 §10: метка хода живого стрима (legacy-сессии — нет).
|
|
508
|
+
turnId: currentStream.turn_id ?? undefined,
|
|
509
|
+
owner: currentStream.owner ?? undefined,
|
|
416
510
|
}
|
|
417
511
|
: undefined,
|
|
512
|
+
// Персистентное состояние ретрая (legacy-записи без поля → undefined).
|
|
513
|
+
retry: deserializeSessionRetry(row.retry),
|
|
418
514
|
summarizationPending: row.summarization_pending ?? false,
|
|
419
515
|
canSummarize: row.can_summarize ?? false,
|
|
420
516
|
createdAt: toIso(row.created_at),
|
|
@@ -436,14 +532,31 @@ export function deserializeSession(row, children) {
|
|
|
436
532
|
}
|
|
437
533
|
/**
|
|
438
534
|
* Строка `sessions` → доменная сессия **без истории** (`SessionRepository.listLight`,
|
|
439
|
-
* ADR-097): `messages`/`
|
|
440
|
-
*
|
|
441
|
-
*
|
|
535
|
+
* ADR-097): `messages`/`checkpoints` пусты, child-таблицы не читаются. **Очередь
|
|
536
|
+
* сохраняется** (`pendingMessages`/`steerInbox` — jsonb-колонки самой `sessions`,
|
|
537
|
+
* истории не тянут, нужны recovery/автозапуску). Метаданные
|
|
538
|
+
* (id/статус/settings/projectId/expiresAt/…) идентичны `deserializeSession` —
|
|
539
|
+
* механика переиспользуется. Для `loadLight` (без очереди) — `deserializeSessionMeta`.
|
|
442
540
|
*/
|
|
443
541
|
export function deserializeSessionLight(row) {
|
|
444
542
|
const session = deserializeSession(row, emptySessionChildren());
|
|
445
543
|
session.messages = [];
|
|
446
|
-
session.pendingMessages = [];
|
|
447
544
|
session.checkpoints = [];
|
|
448
545
|
return session;
|
|
449
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
|
@@ -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 реализаций);
|
|
@@ -57,16 +68,38 @@ export type SessionPorts = Pick<StorageContext, 'sessions'>;
|
|
|
57
68
|
* тест проверяет, что новая колонка (`worktree`, ADR-114) реально попадает в
|
|
58
69
|
* `INSERT` и читается обратно.
|
|
59
70
|
*/
|
|
60
|
-
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", "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"];
|
|
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"];
|
|
61
72
|
/** jsonb-колонки `sessions` (экспортируется для unit-тестов сериализации). */
|
|
62
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>;
|
|
63
77
|
/**
|
|
64
78
|
* Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
|
|
65
79
|
* суррогатный `message_uid` (PK), доменный `id`, `session_id`, позиционный
|
|
66
80
|
* `seq` и `created_at`: они сохраняются от исходной строки (цель ищется по
|
|
67
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-тестов (живая БД не нужна).
|
|
68
101
|
*/
|
|
69
|
-
export declare
|
|
102
|
+
export declare function resolveOrd(requested: unknown, nextOrd: number): number;
|
|
70
103
|
/** Значение для jsonb-колонки: нативный объект/массив → JSON-строка (NUL — вычищены). */
|
|
71
104
|
export declare function jsonParam(value: unknown): string | null;
|
|
72
105
|
/**
|
|
@@ -90,6 +123,12 @@ export declare class PostgresSessionRepository implements SessionRepository {
|
|
|
90
123
|
* транзакция + per-session advisory-лок (как у `save`), `seq = MAX(seq)+1`
|
|
91
124
|
* вычисляется в той же транзакции, `INSERT` одной строки, обновление
|
|
92
125
|
* `sessions.updated_at`. Остальная история не перезаписывается.
|
|
126
|
+
*
|
|
127
|
+
* ADR-118 §2: `ord` — **монотонный** счётчик сессии (`MAX(ord)+1` по
|
|
128
|
+
* сессии), выдаётся в момент материализации записи в историю; ранее
|
|
129
|
+
* выданные значения не перенумеровываются. Если вызывающий уже проставил
|
|
130
|
+
* `ord` (например, перенос записи), его значение сохраняется — порт не
|
|
131
|
+
* перетирает выданный порядок.
|
|
93
132
|
*/
|
|
94
133
|
appendMessage(sessionId: string, message: Message): Promise<Message | null>;
|
|
95
134
|
/**
|
|
@@ -97,11 +136,16 @@ export declare class PostgresSessionRepository implements SessionRepository {
|
|
|
97
136
|
* транзакция + per-session advisory-лок; цель — по `seq` (первая по
|
|
98
137
|
* `seq, created_at, id`), fallback по `id`. `message_uid`/`id`/`seq`/
|
|
99
138
|
* `created_at` исходной строки не меняются, `sessions.updated_at` обновляется.
|
|
139
|
+
*
|
|
140
|
+
* ADR-118: `ord` не перенумеровывается — уже выданное значение сохраняется
|
|
141
|
+
* (`COALESCE(messages.ord, …)`), а ещё не выданное (legacy-строка без
|
|
142
|
+
* `ord`) может быть проставлено (миграция данных ядра).
|
|
100
143
|
*/
|
|
101
144
|
updateMessage(sessionId: string, message: Message): Promise<Message | null>;
|
|
102
145
|
/**
|
|
103
|
-
* Метаданные сессии без истории (`SessionRepository.loadLight`):
|
|
104
|
-
* выборка по PK, child-таблицы не
|
|
146
|
+
* Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
|
|
147
|
+
* одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
|
|
148
|
+
* пусты (очередь отдаёт только `listLight` — recovery/автозапуску).
|
|
105
149
|
*/
|
|
106
150
|
loadLight(sessionId: string): Promise<Session | null>;
|
|
107
151
|
delete(sessionId: string): Promise<void>;
|
package/dist/ports/sessions.js
CHANGED
|
@@ -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 реализаций);
|
|
@@ -46,7 +57,7 @@
|
|
|
46
57
|
*/
|
|
47
58
|
import { jsonbParam } from '../json-param.js';
|
|
48
59
|
import { generateId, makeTextPart, nowISO } from '@itphx/synth-shared';
|
|
49
|
-
import { checkpointRow, deserializeMessage, deserializeReference, deserializeSession, deserializeSessionLight, emptySessionChildren, messageRow, referenceRow, serializeSession, stickyNoteRow, } from './sessions-mapping.js';
|
|
60
|
+
import { checkpointRow, deserializeMessage, deserializeReference, deserializeSession, deserializeSessionLight, deserializeSessionMeta, emptySessionChildren, messageRow, referenceRow, serializeSession, stickyNoteRow, } from './sessions-mapping.js';
|
|
50
61
|
/**
|
|
51
62
|
* Колонки `sessions` (порядок — как в `001_init`).
|
|
52
63
|
*
|
|
@@ -79,6 +90,8 @@ export const SESSION_FIELDS = [
|
|
|
79
90
|
'pending_messages',
|
|
80
91
|
'steer_inbox',
|
|
81
92
|
'current_stream',
|
|
93
|
+
// Персистентное состояние ретрая (jsonb, миграция 030).
|
|
94
|
+
'retry',
|
|
82
95
|
'summarization_pending',
|
|
83
96
|
'can_summarize',
|
|
84
97
|
'created_at',
|
|
@@ -111,12 +124,16 @@ export const SESSION_JSON_FIELDS = new Set([
|
|
|
111
124
|
'pending_messages',
|
|
112
125
|
'steer_inbox',
|
|
113
126
|
'current_stream',
|
|
127
|
+
// Персистентное состояние ретрая (jsonb, миграция 030).
|
|
128
|
+
'retry',
|
|
114
129
|
]);
|
|
115
|
-
/** Колонки `messages` (порядок — как в `001_init`). */
|
|
116
|
-
const MESSAGE_FIELDS = [
|
|
130
|
+
/** Колонки `messages` (порядок — как в `001_init`; `028` — reasoning-подпись). */
|
|
131
|
+
export const MESSAGE_FIELDS = [
|
|
117
132
|
'id',
|
|
118
133
|
'session_id',
|
|
119
134
|
'seq',
|
|
135
|
+
// ADR-118 (миграция `029`): монотонный порядок записи, ход, шаг, статус.
|
|
136
|
+
'ord',
|
|
120
137
|
'role',
|
|
121
138
|
'origin',
|
|
122
139
|
'source_msg_id',
|
|
@@ -133,6 +150,8 @@ const MESSAGE_FIELDS = [
|
|
|
133
150
|
'provider',
|
|
134
151
|
'provider_type',
|
|
135
152
|
'reasoning',
|
|
153
|
+
'reasoning_signature',
|
|
154
|
+
'reasoning_redacted',
|
|
136
155
|
'source',
|
|
137
156
|
'author',
|
|
138
157
|
'agent_role',
|
|
@@ -142,9 +161,12 @@ const MESSAGE_FIELDS = [
|
|
|
142
161
|
'pinned',
|
|
143
162
|
'hidden',
|
|
144
163
|
'ephemeral',
|
|
164
|
+
'turn_id',
|
|
165
|
+
'step_index',
|
|
166
|
+
'status',
|
|
145
167
|
'created_at',
|
|
146
168
|
];
|
|
147
|
-
const MESSAGE_JSON_FIELDS = new Set([
|
|
169
|
+
export const MESSAGE_JSON_FIELDS = new Set([
|
|
148
170
|
'parts',
|
|
149
171
|
'tool_calls',
|
|
150
172
|
'usage',
|
|
@@ -152,14 +174,22 @@ const MESSAGE_JSON_FIELDS = new Set([
|
|
|
152
174
|
'prompt_meta',
|
|
153
175
|
'debug_data',
|
|
154
176
|
'summary_of',
|
|
177
|
+
'reasoning_redacted',
|
|
155
178
|
]);
|
|
156
179
|
/**
|
|
157
180
|
* Колонки `messages`, которые заменяет `updateMessage`. Неизменяемые —
|
|
158
181
|
* суррогатный `message_uid` (PK), доменный `id`, `session_id`, позиционный
|
|
159
182
|
* `seq` и `created_at`: они сохраняются от исходной строки (цель ищется по
|
|
160
183
|
* `seq`, fallback по `id`).
|
|
184
|
+
*
|
|
185
|
+
* ADR-118: `ord` — **не** перенумеровывается обновлением (он иммутабелен
|
|
186
|
+
* после выдачи), поэтому в общий список изменяемых колонок он не входит:
|
|
187
|
+
* `updateMessage` пишет его отдельной фразой `COALESCE(messages.ord, …)` —
|
|
188
|
+
* уже выданное значение сохраняется, а ещё не выданное (legacy-строка) может
|
|
189
|
+
* получить его (так проставляет `ord` миграция данных ядра).
|
|
161
190
|
*/
|
|
162
|
-
export const MESSAGE_MUTABLE_FIELDS = MESSAGE_FIELDS.filter((field) => field !== 'id' && field !== 'session_id' && field !== 'seq'
|
|
191
|
+
export const MESSAGE_MUTABLE_FIELDS = MESSAGE_FIELDS.filter((field) => field !== 'id' && field !== 'session_id' && field !== 'seq'
|
|
192
|
+
&& field !== 'created_at' && field !== 'ord');
|
|
163
193
|
/** Обязательные поля сообщения: безопасные дефолты (паритет с file/memory). */
|
|
164
194
|
function prepareMessage(message) {
|
|
165
195
|
return {
|
|
@@ -172,6 +202,21 @@ function prepareMessage(message) {
|
|
|
172
202
|
createdAt: message.createdAt || nowISO(),
|
|
173
203
|
};
|
|
174
204
|
}
|
|
205
|
+
/**
|
|
206
|
+
* ADR-118 §2: `ord` — **монотонный** счётчик порядка записи в историю
|
|
207
|
+
* сессии (выдаётся при материализации, ранее выданные значения не
|
|
208
|
+
* перенумеровываются).
|
|
209
|
+
*
|
|
210
|
+
* Правило выдачи: уже проставленный вызывателем `ord` **не перетирается**
|
|
211
|
+
* (иначе порядок записей ездил бы); иначе берётся `max(ord)+1` по сессии —
|
|
212
|
+
* значение вычислено в той же транзакции (per-session advisory-лок), поэтому
|
|
213
|
+
* два параллельных append'а не получат один `ord`.
|
|
214
|
+
*
|
|
215
|
+
* Экспортируется для unit-тестов (живая БД не нужна).
|
|
216
|
+
*/
|
|
217
|
+
export function resolveOrd(requested, nextOrd) {
|
|
218
|
+
return Number.isFinite(requested) ? requested : nextOrd;
|
|
219
|
+
}
|
|
175
220
|
const REFERENCE_FIELDS = [
|
|
176
221
|
'id',
|
|
177
222
|
'session_id',
|
|
@@ -321,6 +366,12 @@ export class PostgresSessionRepository {
|
|
|
321
366
|
* транзакция + per-session advisory-лок (как у `save`), `seq = MAX(seq)+1`
|
|
322
367
|
* вычисляется в той же транзакции, `INSERT` одной строки, обновление
|
|
323
368
|
* `sessions.updated_at`. Остальная история не перезаписывается.
|
|
369
|
+
*
|
|
370
|
+
* ADR-118 §2: `ord` — **монотонный** счётчик сессии (`MAX(ord)+1` по
|
|
371
|
+
* сессии), выдаётся в момент материализации записи в историю; ранее
|
|
372
|
+
* выданные значения не перенумеровываются. Если вызывающий уже проставил
|
|
373
|
+
* `ord` (например, перенос записи), его значение сохраняется — порт не
|
|
374
|
+
* перетирает выданный порядок.
|
|
324
375
|
*/
|
|
325
376
|
async appendMessage(sessionId, message) {
|
|
326
377
|
const prepared = prepareMessage(message);
|
|
@@ -329,8 +380,10 @@ export class PostgresSessionRepository {
|
|
|
329
380
|
const present = await tx.query('SELECT EXISTS (SELECT 1 FROM sessions WHERE id = $1) AS present', [sessionId]);
|
|
330
381
|
if (present[0]?.present !== true)
|
|
331
382
|
return null;
|
|
332
|
-
const next = await tx.query('SELECT COALESCE(MAX(seq), 0) + 1 AS seq
|
|
383
|
+
const next = await tx.query('SELECT COALESCE(MAX(seq), 0) + 1 AS seq, COALESCE(MAX(ord), 0) + 1 AS ord '
|
|
384
|
+
+ 'FROM messages WHERE session_id = $1', [sessionId]);
|
|
333
385
|
const seq = Number(next[0]?.seq ?? 1);
|
|
386
|
+
prepared.ord = resolveOrd(prepared.ord, Number(next[0]?.ord ?? 1));
|
|
334
387
|
const row = messageRow(prepared, sessionId, seq);
|
|
335
388
|
const placeholders = MESSAGE_FIELDS.map((_, index) => `$${index + 1}`).join(', ');
|
|
336
389
|
const inserted = await tx.query(`INSERT INTO messages (${MESSAGE_FIELDS.join(', ')}) VALUES (${placeholders}) RETURNING *`, rowValues(row, MESSAGE_FIELDS, MESSAGE_JSON_FIELDS));
|
|
@@ -344,14 +397,21 @@ export class PostgresSessionRepository {
|
|
|
344
397
|
* транзакция + per-session advisory-лок; цель — по `seq` (первая по
|
|
345
398
|
* `seq, created_at, id`), fallback по `id`. `message_uid`/`id`/`seq`/
|
|
346
399
|
* `created_at` исходной строки не меняются, `sessions.updated_at` обновляется.
|
|
400
|
+
*
|
|
401
|
+
* ADR-118: `ord` не перенумеровывается — уже выданное значение сохраняется
|
|
402
|
+
* (`COALESCE(messages.ord, …)`), а ещё не выданное (legacy-строка без
|
|
403
|
+
* `ord`) может быть проставлено (миграция данных ядра).
|
|
347
404
|
*/
|
|
348
405
|
async updateMessage(sessionId, message) {
|
|
349
406
|
const prepared = prepareMessage(message);
|
|
350
407
|
const row = messageRow(prepared, sessionId, prepared.seq);
|
|
351
|
-
const
|
|
352
|
-
.map((field, index) => `${field} = $${index + 1}`)
|
|
353
|
-
.join(', ');
|
|
408
|
+
const setClauses = MESSAGE_MUTABLE_FIELDS.map((field, index) => `${field} = $${index + 1}`);
|
|
354
409
|
const params = rowValues(row, MESSAGE_MUTABLE_FIELDS, MESSAGE_JSON_FIELDS);
|
|
410
|
+
if (prepared.ord !== undefined && prepared.ord !== null) {
|
|
411
|
+
params.push(prepared.ord);
|
|
412
|
+
setClauses.push(`ord = COALESCE(messages.ord, $${params.length})`);
|
|
413
|
+
}
|
|
414
|
+
const setSql = setClauses.join(', ');
|
|
355
415
|
return this._connection.withTransaction(async (tx) => {
|
|
356
416
|
await this._lockSession(tx, sessionId);
|
|
357
417
|
const messageUid = await this._findMessageUid(tx, sessionId, prepared);
|
|
@@ -364,13 +424,14 @@ export class PostgresSessionRepository {
|
|
|
364
424
|
});
|
|
365
425
|
}
|
|
366
426
|
/**
|
|
367
|
-
* Метаданные сессии без истории (`SessionRepository.loadLight`):
|
|
368
|
-
* выборка по PK, child-таблицы не
|
|
427
|
+
* Метаданные сессии без истории и без очереди (`SessionRepository.loadLight`):
|
|
428
|
+
* одна выборка по PK, child-таблицы не читаются, `pendingMessages`/`steerInbox`
|
|
429
|
+
* пусты (очередь отдаёт только `listLight` — recovery/автозапуску).
|
|
369
430
|
*/
|
|
370
431
|
async loadLight(sessionId) {
|
|
371
432
|
const rows = await this._connection.query('SELECT * FROM sessions WHERE id = $1', [sessionId]);
|
|
372
433
|
const row = rows[0];
|
|
373
|
-
return row ?
|
|
434
|
+
return row ? deserializeSessionMeta(row) : null;
|
|
374
435
|
}
|
|
375
436
|
async delete(sessionId) {
|
|
376
437
|
await this._connection.withTransaction(async (tx) => {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-storage-postgres",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.4",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -15,13 +15,13 @@
|
|
|
15
15
|
}
|
|
16
16
|
},
|
|
17
17
|
"dependencies": {
|
|
18
|
-
"@itphx/synth-shared": "0.
|
|
18
|
+
"@itphx/synth-shared": "0.13.4"
|
|
19
19
|
},
|
|
20
20
|
"peerDependencies": {
|
|
21
|
-
"@itphx/synth-core": "0.
|
|
21
|
+
"@itphx/synth-core": "0.13.4"
|
|
22
22
|
},
|
|
23
23
|
"devDependencies": {
|
|
24
|
-
"@itphx/synth-core": "0.
|
|
24
|
+
"@itphx/synth-core": "0.13.4",
|
|
25
25
|
"@types/node": "^22.0.0",
|
|
26
26
|
"@types/pg": "^8.15.0",
|
|
27
27
|
"typescript": "^5.8.0"
|