@itphx/synth-sdk 0.13.4 → 0.13.10
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/client.d.ts +62 -2
- package/dist/client.js +38 -0
- package/dist/index.d.ts +1 -1
- package/dist/types.d.ts +108 -6
- package/package.json +3 -3
package/dist/client.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ChatCompletionsRequest, ChatCompletionsResponse, EventBinding, EventBindingApiKey, EventBindingApiKeyCreateRequest, EventBindingApiKeyCreated, EventBindingApiKeyUpdateRequest, EventBindingInputRequest, EventIngestRequest, EventIngestResponse, EventJournalEntry, EventRouteRule, EventRouteRuleUpsertRequest, FsListParams, FsListResult, FsReadParams, FsReadResult, GitCommitParams, GitCommitResult, InstanceCapabilities, ModelListResponse, ModelsListParams, PipelineRunResponse, ProjectListResponse, ProjectPipelinesResponse, PromptAcceptedResponse, Schedule, ScheduleInput, ScheduleJob, SerializedProject, SerializedSession, SessionCreateInput, SessionListResponse, SessionMessagesResponse, SessionPatch, SessionPromptInput, SessionStatusResponse } from './types.js';
|
|
1
|
+
import type { ChatCompletionsRequest, ChatCompletionsResponse, EventBinding, EventBindingApiKey, EventBindingApiKeyCreateRequest, EventBindingApiKeyCreated, EventBindingApiKeyUpdateRequest, EventBindingInputRequest, EventIngestRequest, EventIngestResponse, EventJournalEntry, EventRouteRule, EventRouteRuleUpsertRequest, FsListParams, FsListResult, FsReadParams, FsReadResult, GitCommitParams, GitCommitResult, InstanceCapabilities, ModelListResponse, ModelsListParams, PipelineRunResponse, PlanColumnCreateRequest, PlanColumnDeleteRequest, PlanColumnsOrderRequest, PlanColumnUpdateRequest, PlanItemCreateRequest, PlanItemMoveRequest, PlanItemUpdateRequest, ProjectInvariantsResponse, ProjectInvariantsUpdateRequest, ProjectListResponse, ProjectLogCreateRequest, ProjectLogEntryResponse, ProjectLogPage, ProjectLogUpdateRequest, ProjectPipelinesResponse, ProjectPlanMutationResponse, ProjectPlanResponse, PromptAcceptedResponse, Schedule, ScheduleInput, ScheduleJob, SerializedProject, SerializedSession, SessionCreateInput, SessionListResponse, SessionMessagesResponse, SessionPatch, SessionPromptInput, SessionStatusResponse, SessionTodosResponse, TodoClearRequest, TodoCreateRequest, TodoOrderRequest, TodoUpdateRequest } from './types.js';
|
|
2
2
|
/** Базовый путь API v2 по умолчанию. */
|
|
3
3
|
export declare const DEFAULT_API_PATH = "/api/v2";
|
|
4
4
|
/** Значения query-параметров (`null`/`undefined` пропускаются). */
|
|
@@ -65,6 +65,19 @@ export interface ProjectPipelinesParams {
|
|
|
65
65
|
/** Смещение страницы (с 0). */
|
|
66
66
|
offset?: number;
|
|
67
67
|
}
|
|
68
|
+
/**
|
|
69
|
+
* Query-параметры страницы журнала проекта.
|
|
70
|
+
*
|
|
71
|
+
* Тип-алиас (не interface) — см. `ModelsListParams`: у набора
|
|
72
|
+
* query-параметров TypeScript выводит неявный индекс-сигнатур (нужно для
|
|
73
|
+
* приведения к `SynthQuery` в клиенте).
|
|
74
|
+
*/
|
|
75
|
+
export type ProjectLogParams = {
|
|
76
|
+
/** Размер страницы (1..200; по умолчанию 50). */
|
|
77
|
+
limit?: number;
|
|
78
|
+
/** Смещение страницы (с 0). */
|
|
79
|
+
offset?: number;
|
|
80
|
+
};
|
|
68
81
|
/**
|
|
69
82
|
* Query-параметры журнала прогона.
|
|
70
83
|
*
|
|
@@ -120,6 +133,18 @@ export interface SessionsNamespace {
|
|
|
120
133
|
/** Страница истории сообщений (`{messages, session_id, has_more, next_before}`). */
|
|
121
134
|
messages(id: string, params?: SessionMessagesParams): Promise<SessionMessagesResponse>;
|
|
122
135
|
status(id: string): Promise<SessionStatusResponse>;
|
|
136
|
+
/** Список задач сессии (ToDo, PROP-054): `{todos}`. */
|
|
137
|
+
sessionTodos(id: string): Promise<SessionTodosResponse>;
|
|
138
|
+
/** Создать пункт ToDo → актуальный список `{todos}`. */
|
|
139
|
+
createSessionTodo(id: string, body: TodoCreateRequest): Promise<SessionTodosResponse>;
|
|
140
|
+
/** Правка пункта ToDo → актуальный список `{todos}`. */
|
|
141
|
+
updateSessionTodo(id: string, todoId: string, body: TodoUpdateRequest): Promise<SessionTodosResponse>;
|
|
142
|
+
/** Удаление пункта ToDo → актуальный список `{todos}`. */
|
|
143
|
+
deleteSessionTodo(id: string, todoId: string): Promise<SessionTodosResponse>;
|
|
144
|
+
/** Новый порядок пунктов ToDo (`{ids}`) → актуальный список `{todos}`. */
|
|
145
|
+
reorderSessionTodos(id: string, body: TodoOrderRequest): Promise<SessionTodosResponse>;
|
|
146
|
+
/** Очистка пунктов ToDo по статусам (по умолчанию — `completed` + `cancelled`). */
|
|
147
|
+
clearSessionTodos(id: string, body?: TodoClearRequest): Promise<SessionTodosResponse>;
|
|
123
148
|
}
|
|
124
149
|
/** Namespace `schedules` (ADR-051). */
|
|
125
150
|
export interface SchedulesNamespace {
|
|
@@ -167,12 +192,47 @@ export interface GitNamespace {
|
|
|
167
192
|
* Список — **страница** (`{projects, total, offset, limit, next_offset}`) со
|
|
168
193
|
* сводкой-DTO: тяжёлые поля `log`/`plan` в списке не отдаются (деталь — полный
|
|
169
194
|
* DTO).
|
|
195
|
+
*
|
|
196
|
+
* PROP-054: журнал проекта **вынесен из детали** — деталь (`GET /:id`) поля
|
|
197
|
+
* `log` не содержит, записи журнала читаются постранично через `projectLog()`.
|
|
198
|
+
* План, инварианты и журнал мутируются точечными операциями (`projectPlan()`,
|
|
199
|
+
* `projectInvariants()`, `projectLog()`), а не через `PUT /projects/:id`.
|
|
170
200
|
*/
|
|
171
201
|
export interface ProjectsNamespace {
|
|
172
202
|
/** Страница списка проектов. */
|
|
173
203
|
list(params?: ProjectsListParams): Promise<ProjectListResponse>;
|
|
174
|
-
/** Проект по id (полный DTO — с `
|
|
204
|
+
/** Проект по id (полный DTO — с `plan`; **без** `log`). */
|
|
175
205
|
get(id: string): Promise<SerializedProject>;
|
|
206
|
+
/** План проекта (`GET /:id/plan`): `{plan}` (`plan: null` — плана нет). */
|
|
207
|
+
projectPlan(id: string): Promise<ProjectPlanResponse>;
|
|
208
|
+
/** Создать пункт плана (`POST /:id/plan/items`) → `{plan}`. */
|
|
209
|
+
createPlanItem(id: string, body: PlanItemCreateRequest): Promise<ProjectPlanMutationResponse>;
|
|
210
|
+
/** Правка полей пункта плана (`PATCH /:id/plan/items/:itemId`) → `{plan}`. */
|
|
211
|
+
updatePlanItem(id: string, itemId: string, body: PlanItemUpdateRequest): Promise<ProjectPlanMutationResponse>;
|
|
212
|
+
/** Перемещение пункта плана (`PATCH /:id/plan/items/:itemId/move`) → `{plan}`. */
|
|
213
|
+
movePlanItem(id: string, itemId: string, body: PlanItemMoveRequest): Promise<ProjectPlanMutationResponse>;
|
|
214
|
+
/** Удаление пункта плана (`DELETE /:id/plan/items/:itemId`) → `{plan}`. */
|
|
215
|
+
deletePlanItem(id: string, itemId: string): Promise<ProjectPlanMutationResponse>;
|
|
216
|
+
/** Создание колонки плана (`POST /:id/plan/columns`) → `{plan}`. */
|
|
217
|
+
createPlanColumn(id: string, body: PlanColumnCreateRequest): Promise<ProjectPlanMutationResponse>;
|
|
218
|
+
/** Правка колонки плана (`PATCH /:id/plan/columns/:columnId`) → `{plan}`. */
|
|
219
|
+
updatePlanColumn(id: string, columnId: string, body: PlanColumnUpdateRequest): Promise<ProjectPlanMutationResponse>;
|
|
220
|
+
/** Удаление колонки плана (`DELETE /:id/plan/columns/:columnId`) → `{plan}`. */
|
|
221
|
+
deletePlanColumn(id: string, columnId: string, body: PlanColumnDeleteRequest): Promise<ProjectPlanMutationResponse>;
|
|
222
|
+
/** Новый порядок колонок (`PUT /:id/plan/columns/order`) → `{plan}`. */
|
|
223
|
+
reorderPlanColumns(id: string, body: PlanColumnsOrderRequest): Promise<ProjectPlanMutationResponse>;
|
|
224
|
+
/** Страница журнала проекта (`GET /:id/log`): `{entries, total, offset, limit, next_offset}`. */
|
|
225
|
+
projectLog(id: string, params?: ProjectLogParams): Promise<ProjectLogPage>;
|
|
226
|
+
/** Новая запись журнала (`POST /:id/log`) → `{entry}`. */
|
|
227
|
+
createProjectLogEntry(id: string, body: ProjectLogCreateRequest): Promise<ProjectLogEntryResponse>;
|
|
228
|
+
/** Правка записи журнала (`PATCH /:id/log/:entryId`) → `{entry}`. */
|
|
229
|
+
updateProjectLogEntry(id: string, entryId: string, body: ProjectLogUpdateRequest): Promise<ProjectLogEntryResponse>;
|
|
230
|
+
/** Удаление записи журнала (`DELETE /:id/log/:entryId`) → 204. */
|
|
231
|
+
deleteProjectLogEntry(id: string, entryId: string): Promise<void>;
|
|
232
|
+
/** Инварианты проекта (`GET /:id/invariants`): `{invariants, updated_at}`. */
|
|
233
|
+
projectInvariants(id: string): Promise<ProjectInvariantsResponse>;
|
|
234
|
+
/** Замена инвариантов (`PUT /:id/invariants`) → `{invariants, updated_at}`. */
|
|
235
|
+
putProjectInvariants(id: string, body: ProjectInvariantsUpdateRequest): Promise<ProjectInvariantsResponse>;
|
|
176
236
|
}
|
|
177
237
|
/**
|
|
178
238
|
* Namespace `pipelines` (ADR-101): пайплайны проекта и прогон с журналом.
|
package/dist/client.js
CHANGED
|
@@ -88,6 +88,21 @@ export class SynthClient {
|
|
|
88
88
|
query: params,
|
|
89
89
|
}),
|
|
90
90
|
status: (id) => this._request(`/sessions/${encodeURIComponent(id)}/status`),
|
|
91
|
+
sessionTodos: (id) => this._request(`/sessions/${encodeURIComponent(id)}/todos`),
|
|
92
|
+
createSessionTodo: (id, body) => this._request(`/sessions/${encodeURIComponent(id)}/todos`, {
|
|
93
|
+
method: 'POST',
|
|
94
|
+
body,
|
|
95
|
+
}),
|
|
96
|
+
updateSessionTodo: (id, todoId, body) => this._request(`/sessions/${encodeURIComponent(id)}/todos/${encodeURIComponent(todoId)}`, { method: 'PATCH', body }),
|
|
97
|
+
deleteSessionTodo: (id, todoId) => this._request(`/sessions/${encodeURIComponent(id)}/todos/${encodeURIComponent(todoId)}`, { method: 'DELETE' }),
|
|
98
|
+
reorderSessionTodos: (id, body) => this._request(`/sessions/${encodeURIComponent(id)}/todos/order`, {
|
|
99
|
+
method: 'PUT',
|
|
100
|
+
body,
|
|
101
|
+
}),
|
|
102
|
+
clearSessionTodos: (id, body) => this._request(`/sessions/${encodeURIComponent(id)}/todos/clear`, {
|
|
103
|
+
method: 'POST',
|
|
104
|
+
body,
|
|
105
|
+
}),
|
|
91
106
|
};
|
|
92
107
|
this.schedules = {
|
|
93
108
|
list: () => this._request('/schedules').then((r) => r.schedules ?? []),
|
|
@@ -115,6 +130,29 @@ export class SynthClient {
|
|
|
115
130
|
query: params,
|
|
116
131
|
}),
|
|
117
132
|
get: (id) => this._request(`/projects/${encodeURIComponent(id)}`),
|
|
133
|
+
projectPlan: (id) => this._request(`/projects/${encodeURIComponent(id)}/plan`),
|
|
134
|
+
createPlanItem: (id, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/items`, { method: 'POST', body }),
|
|
135
|
+
updatePlanItem: (id, itemId, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/items/${encodeURIComponent(itemId)}`, { method: 'PATCH', body }),
|
|
136
|
+
movePlanItem: (id, itemId, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/items/${encodeURIComponent(itemId)}/move`, { method: 'PATCH', body }),
|
|
137
|
+
deletePlanItem: (id, itemId) => this._request(`/projects/${encodeURIComponent(id)}/plan/items/${encodeURIComponent(itemId)}`, { method: 'DELETE' }),
|
|
138
|
+
createPlanColumn: (id, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/columns`, { method: 'POST', body }),
|
|
139
|
+
updatePlanColumn: (id, columnId, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/columns/${encodeURIComponent(columnId)}`, { method: 'PATCH', body }),
|
|
140
|
+
deletePlanColumn: (id, columnId, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/columns/${encodeURIComponent(columnId)}`, { method: 'DELETE', body }),
|
|
141
|
+
reorderPlanColumns: (id, body) => this._request(`/projects/${encodeURIComponent(id)}/plan/columns/order`, { method: 'PUT', body }),
|
|
142
|
+
projectLog: (id, params) => this._request(`/projects/${encodeURIComponent(id)}/log`, {
|
|
143
|
+
query: params,
|
|
144
|
+
}),
|
|
145
|
+
createProjectLogEntry: (id, body) => this._request(`/projects/${encodeURIComponent(id)}/log`, {
|
|
146
|
+
method: 'POST',
|
|
147
|
+
body,
|
|
148
|
+
}),
|
|
149
|
+
updateProjectLogEntry: (id, entryId, body) => this._request(`/projects/${encodeURIComponent(id)}/log/${encodeURIComponent(entryId)}`, { method: 'PATCH', body }),
|
|
150
|
+
deleteProjectLogEntry: (id, entryId) => this._request(`/projects/${encodeURIComponent(id)}/log/${encodeURIComponent(entryId)}`, { method: 'DELETE' }),
|
|
151
|
+
projectInvariants: (id) => this._request(`/projects/${encodeURIComponent(id)}/invariants`),
|
|
152
|
+
putProjectInvariants: (id, body) => this._request(`/projects/${encodeURIComponent(id)}/invariants`, {
|
|
153
|
+
method: 'PUT',
|
|
154
|
+
body,
|
|
155
|
+
}),
|
|
118
156
|
};
|
|
119
157
|
this.pipelines = {
|
|
120
158
|
projectPipelines: (projectId, params) => this._request(`/projects/${encodeURIComponent(projectId)}/pipelines`, { query: params }),
|
package/dist/index.d.ts
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
* ```
|
|
15
15
|
*/
|
|
16
16
|
export { SynthClient, createSynthClient, DEFAULT_API_PATH } from './client.js';
|
|
17
|
-
export type { SynthClientOptions, SynthQuery, EventsNamespace, SessionsNamespace, SchedulesNamespace, ProjectsNamespace, PipelinesNamespace, LlmNamespace, ModelsNamespace, FsNamespace, GitNamespace, SessionsListParams, SessionMessagesParams, EventJournalParams, ScheduleJobsParams, ProjectsListParams, ProjectPipelinesParams, PipelineRunParams, } from './client.js';
|
|
17
|
+
export type { SynthClientOptions, SynthQuery, EventsNamespace, SessionsNamespace, SchedulesNamespace, ProjectsNamespace, PipelinesNamespace, LlmNamespace, ModelsNamespace, FsNamespace, GitNamespace, SessionsListParams, SessionMessagesParams, EventJournalParams, ScheduleJobsParams, ProjectsListParams, ProjectPipelinesParams, ProjectLogParams, PipelineRunParams, } from './client.js';
|
|
18
18
|
export { SynthApiError, isSynthApiError, parseErrorBody, HTTP_ERROR_CODE, NETWORK_ERROR_CODE, } from './errors.js';
|
|
19
19
|
export type { SynthApiErrorInit } from './errors.js';
|
|
20
20
|
export type * from './types.js';
|
package/dist/types.d.ts
CHANGED
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
* срез сериализованной сессии (`serializeSession`) и OpenAI-совместимый
|
|
8
8
|
* контракт LLM-прокси (источник — `public-openapi.ts`).
|
|
9
9
|
*/
|
|
10
|
-
import type { CommitDetail, EventBinding, EventBindingApiKey, EventBindingApiKeyCreated, EventRouteRule, FileEntry, InstanceCapabilities, PromptAcceptedResponse, RouteDecision, Schedule, ScheduleJob, SynthEvent } from '@itphx/synth-shared/types';
|
|
11
|
-
import type { EventBindingApiKeyCreateRequest, EventBindingApiKeyUpdateRequest, EventBindingInputRequest, EventIngestRequest, EventRouteRuleUpsertRequest, PromptRequest, PromptRequestInput, ScheduleInputRequest, SessionCreateRequest, SessionUpdateRequest } from '@itphx/synth-shared/schemas';
|
|
12
|
-
export type { CommitDetail, EventBinding, EventBindingApiKey, EventBindingApiKeyCreateRequest, EventBindingApiKeyCreated, EventBindingApiKeyUpdateRequest, EventBindingInputRequest, EventIngestRequest, EventRouteRule, EventRouteRuleUpsertRequest, FileEntry, InstanceCapabilities, PromptAcceptedResponse, PromptRequest, PromptRequestInput, RouteDecision, Schedule, ScheduleInputRequest, ScheduleJob, SessionCreateRequest, SessionUpdateRequest, SynthEvent, };
|
|
10
|
+
import type { CommitDetail, EventBinding, EventBindingApiKey, EventBindingApiKeyCreated, EventRouteRule, FileEntry, InstanceCapabilities, ProjectPlan, PromptAcceptedResponse, RouteDecision, Schedule, ScheduleJob, SynthEvent, TodoItem } from '@itphx/synth-shared/types';
|
|
11
|
+
import type { EventBindingApiKeyCreateRequest, EventBindingApiKeyUpdateRequest, EventBindingInputRequest, EventIngestRequest, EventRouteRuleUpsertRequest, PlanColumnCreateRequest, PlanColumnDeleteRequest, PlanColumnsOrderRequest, PlanColumnUpdateRequest, PlanItemCreateRequest, PlanItemMoveRequest, PlanItemUpdateRequest, ProjectInvariantsUpdateRequest, ProjectLogCreateRequest, ProjectLogUpdateRequest, PromptRequest, PromptRequestInput, ScheduleInputRequest, SessionCreateRequest, SessionUpdateRequest, TodoClearRequest, TodoCreateRequest, TodoOrderRequest, TodoUpdateRequest } from '@itphx/synth-shared/schemas';
|
|
12
|
+
export type { CommitDetail, EventBinding, EventBindingApiKey, EventBindingApiKeyCreateRequest, EventBindingApiKeyCreated, EventBindingApiKeyUpdateRequest, EventBindingInputRequest, EventIngestRequest, EventRouteRule, EventRouteRuleUpsertRequest, FileEntry, InstanceCapabilities, PlanColumnCreateRequest, PlanColumnDeleteRequest, PlanColumnsOrderRequest, PlanColumnUpdateRequest, PlanItemCreateRequest, PlanItemMoveRequest, PlanItemUpdateRequest, ProjectInvariantsUpdateRequest, ProjectLogCreateRequest, ProjectLogUpdateRequest, ProjectPlan, PromptAcceptedResponse, PromptRequest, PromptRequestInput, RouteDecision, Schedule, ScheduleInputRequest, ScheduleJob, SessionCreateRequest, SessionUpdateRequest, SynthEvent, TodoClearRequest, TodoCreateRequest, TodoItem, TodoOrderRequest, TodoUpdateRequest, };
|
|
13
13
|
/** Тело `POST /sessions` — публичный контракт `SessionCreateRequest` из shared. */
|
|
14
14
|
export type SessionCreateInput = SessionCreateRequest;
|
|
15
15
|
/**
|
|
@@ -161,11 +161,21 @@ export interface SessionStatusResponse {
|
|
|
161
161
|
processor_running: boolean;
|
|
162
162
|
}
|
|
163
163
|
/**
|
|
164
|
-
* Публичный срез сериализованного проекта (`
|
|
164
|
+
* Публичный срез сериализованного проекта (`serializeProject` в core) —
|
|
165
165
|
* транспортный DTO в snake_case.
|
|
166
166
|
*
|
|
167
|
-
* Сводка
|
|
168
|
-
* отдаются**; полный DTO — в
|
|
167
|
+
* Сводка списка (`serializeProjectSummary`): тяжёлые поля `log` (журнал
|
|
168
|
+
* проекта) и `plan` (ADR-039) **не отдаются**; полный DTO — в
|
|
169
|
+
* `GET /projects/:id`.
|
|
170
|
+
*
|
|
171
|
+
* PROP-054: в детали проекта поля `log` **больше нет** — журнал вынесен в
|
|
172
|
+
* постраничную страницу `GET /projects/:id/log` (см. `ProjectLogPage`).
|
|
173
|
+
* Поле `plan` в детали остаётся (`plan: null` — плана нет).
|
|
174
|
+
*
|
|
175
|
+
* ⚠️ У типа есть индекс-сигнатура `[key: string]: unknown` — «удаление» поля
|
|
176
|
+
* `log` из ответа сервера **не ломает компиляцию** (значение просто попадёт в
|
|
177
|
+
* индекс). Поэтому отсутствие `log` в детали закреплено явным тестом
|
|
178
|
+
* (`client.test.ts`), а не типом.
|
|
169
179
|
*/
|
|
170
180
|
export interface SerializedProject {
|
|
171
181
|
id: string;
|
|
@@ -173,6 +183,12 @@ export interface SerializedProject {
|
|
|
173
183
|
name: string;
|
|
174
184
|
owner_id: string;
|
|
175
185
|
members: Record<string, string>;
|
|
186
|
+
/** PROP-133 §3.2: гранты группам (`null` — групп нет). */
|
|
187
|
+
group_members?: Record<string, string> | null;
|
|
188
|
+
/** PROP-133 §3.2: роль для всех пользователей инстанса (`null` — не опубликован). */
|
|
189
|
+
everyone_role?: string | null;
|
|
190
|
+
/** PROP-133 §3.2: производная видимость проекта (`author`/`selected`/`all`). */
|
|
191
|
+
visibility?: 'author' | 'selected' | 'all';
|
|
176
192
|
description: string;
|
|
177
193
|
current_task: string;
|
|
178
194
|
invariants: string;
|
|
@@ -182,6 +198,8 @@ export interface SerializedProject {
|
|
|
182
198
|
repos?: unknown[] | null;
|
|
183
199
|
mcp?: unknown | null;
|
|
184
200
|
memory?: unknown | null;
|
|
201
|
+
/** План проекта (ADR-039); `null` — плана нет. В списке проектов не отдаётся. */
|
|
202
|
+
plan?: ProjectPlan | null;
|
|
185
203
|
status_messages: Array<{
|
|
186
204
|
id: string;
|
|
187
205
|
text: string;
|
|
@@ -208,6 +226,90 @@ export interface ProjectListResponse {
|
|
|
208
226
|
/** Курсор следующей страницы; `null` — страница последняя. */
|
|
209
227
|
next_offset: number | null;
|
|
210
228
|
}
|
|
229
|
+
/**
|
|
230
|
+
* DTO записи журнала проекта (`serializeLogEntry` в core) — транспортный
|
|
231
|
+
* DTO в snake_case. Текст — Markdown (лимит `MARKDOWN_LIMITS.journalEntry`,
|
|
232
|
+
* 16 КиБ).
|
|
233
|
+
*/
|
|
234
|
+
export interface ProjectLogEntryDto {
|
|
235
|
+
id: string;
|
|
236
|
+
text: string;
|
|
237
|
+
created_at: string;
|
|
238
|
+
/** Сессия-автор записи; `null` — запись без сессии. */
|
|
239
|
+
session_id: string | null;
|
|
240
|
+
/** Автор записи; `null` — автор не задан. */
|
|
241
|
+
author: string | null;
|
|
242
|
+
/** Когда текст правили; `null` — запись не правилась. */
|
|
243
|
+
updated_at: string | null;
|
|
244
|
+
/** Кто правил текст; `null` — не правили. */
|
|
245
|
+
updated_by: string | null;
|
|
246
|
+
[key: string]: unknown;
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* Ответ `POST`/`PATCH` `/projects/:id/log*` — созданная или обновлённая запись
|
|
250
|
+
* журнала.
|
|
251
|
+
*/
|
|
252
|
+
export interface ProjectLogEntryResponse {
|
|
253
|
+
entry: ProjectLogEntryDto;
|
|
254
|
+
}
|
|
255
|
+
/**
|
|
256
|
+
* Ответ `GET /projects/:id/log` — **страница** журнала проекта.
|
|
257
|
+
*
|
|
258
|
+
* Новые записи сверху; пагинация — общий формат API v2
|
|
259
|
+
* (`{items, total, offset, limit, next_offset}`).
|
|
260
|
+
*/
|
|
261
|
+
export interface ProjectLogPage {
|
|
262
|
+
/** Записи текущей страницы (новые сверху). */
|
|
263
|
+
entries: ProjectLogEntryDto[];
|
|
264
|
+
/** Всего записей журнала. */
|
|
265
|
+
total: number;
|
|
266
|
+
/** Смещение текущей страницы. */
|
|
267
|
+
offset: number;
|
|
268
|
+
/** Размер страницы (по умолчанию 50, максимум 200). */
|
|
269
|
+
limit: number;
|
|
270
|
+
/** Курсор следующей страницы; `null` — страница последняя. */
|
|
271
|
+
next_offset: number | null;
|
|
272
|
+
}
|
|
273
|
+
/**
|
|
274
|
+
* Ответ `GET /projects/:id/plan` — план проекта целиком.
|
|
275
|
+
*
|
|
276
|
+
* `plan: null` — плана ещё нет. ⚠️ План приходит **доменной формой**
|
|
277
|
+
* (camelCase: `updatedAt`/`columnId`/`createdAt`) — в отличие от журнала и
|
|
278
|
+
* инвариантов, которые сериализуются в snake_case.
|
|
279
|
+
*/
|
|
280
|
+
export interface ProjectPlanResponse {
|
|
281
|
+
plan: ProjectPlan | null;
|
|
282
|
+
}
|
|
283
|
+
/**
|
|
284
|
+
* Ответ мутации плана — **актуальный** план после операции.
|
|
285
|
+
*
|
|
286
|
+
* При конфликте версии сервер отвечает `409 PLAN_VERSION_CONFLICT` и кладёт
|
|
287
|
+
* актуальный план в тело ошибки (`plan`) — клиент читает его из
|
|
288
|
+
* `SynthApiError.body`.
|
|
289
|
+
*/
|
|
290
|
+
export interface ProjectPlanMutationResponse {
|
|
291
|
+
plan: ProjectPlan;
|
|
292
|
+
}
|
|
293
|
+
/**
|
|
294
|
+
* Ответ `GET`/`PUT /projects/:id/invariants` — текст инвариантов проекта и
|
|
295
|
+
* время его записи.
|
|
296
|
+
*
|
|
297
|
+
* Текст — Markdown (лимит `MARKDOWN_LIMITS.invariants`, 64 КиБ).
|
|
298
|
+
*/
|
|
299
|
+
export interface ProjectInvariantsResponse {
|
|
300
|
+
invariants: string;
|
|
301
|
+
updated_at: string;
|
|
302
|
+
}
|
|
303
|
+
/**
|
|
304
|
+
* Ответ ToDo-эндпоинтов сессии (`GET`/`POST`/`PATCH`/`DELETE`
|
|
305
|
+
* `/sessions/:id/todos*`) — текущий список задач сессии.
|
|
306
|
+
*
|
|
307
|
+
* Порядок пунктов — порядок массива; текст — Markdown (лимит
|
|
308
|
+
* `MARKDOWN_LIMITS.todoContent`, 4 КиБ).
|
|
309
|
+
*/
|
|
310
|
+
export interface SessionTodosResponse {
|
|
311
|
+
todos: TodoItem[];
|
|
312
|
+
}
|
|
211
313
|
/**
|
|
212
314
|
* Сводка пайплайна проекта (`pipelineSummary` в core). Поля — как у порта
|
|
213
315
|
* (camelCase); черновик (`draft`) в сводку **не входит** — он в детали
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-sdk",
|
|
3
|
-
"version": "0.13.
|
|
3
|
+
"version": "0.13.10",
|
|
4
4
|
"description": "Типизированный клиент публичного API Synth (ADR-052)",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
}
|
|
17
17
|
},
|
|
18
18
|
"dependencies": {
|
|
19
|
-
"@itphx/synth-shared": "0.13.
|
|
19
|
+
"@itphx/synth-shared": "0.13.10"
|
|
20
20
|
},
|
|
21
21
|
"devDependencies": {
|
|
22
22
|
"@types/node": "^22.0.0",
|
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
"scripts": {
|
|
37
37
|
"build": "rm -rf dist && tsc -p tsconfig.build.json",
|
|
38
38
|
"typecheck": "tsc --noEmit",
|
|
39
|
-
"lint": "eslint src/",
|
|
39
|
+
"lint": "eslint src/ --max-warnings 0",
|
|
40
40
|
"test": "vitest run",
|
|
41
41
|
"test:watch": "vitest",
|
|
42
42
|
"clean": "rm -rf dist"
|