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