@ykurilov/agent-chat-core 0.82.0 → 0.83.0
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/CHANGELOG.md +22 -0
- package/dist/{chunk-YGHGURNF.js → chunk-GXJNYXC5.js} +297 -57
- package/dist/chunk-GXJNYXC5.js.map +1 -0
- package/dist/index.js +20 -6
- package/dist/index.js.map +1 -1
- package/dist/storage-contract.js +44 -3
- package/dist/storage-contract.js.map +1 -1
- package/dist/types/agent-run/answer-liveness.d.ts +1 -1
- package/dist/types/agent-run/answer-saver.d.ts +2 -2
- package/dist/types/agent-run/run-agent-turn.d.ts +2 -0
- package/dist/types/agent-run/tool-call-gate.d.ts +1 -1
- package/dist/types/chat-turn-lease.d.ts +7 -0
- package/dist/types/chat-turn-storage.d.ts +7 -0
- package/dist/types/index.d.ts +2 -2
- package/dist/types/storage/chat-storage.d.ts +16 -5
- package/package.json +1 -1
- package/dist/chunk-YGHGURNF.js.map +0 -1
|
@@ -10,7 +10,7 @@ export declare const ANSWER_ALIVE_EVERY_MS = 5000;
|
|
|
10
10
|
/** Ответ без знака жизни дольше этого — брошен упавшей копией: три пропущенных знака подряд. */
|
|
11
11
|
export declare const ANSWER_STALE_AFTER_MS: number;
|
|
12
12
|
/**
|
|
13
|
-
* Как часто служба ищет брошенные
|
|
13
|
+
* Как часто служба ищет брошенные ответы: обход включён при создании службы до `flush`. Вместе с порогом это окно, когда
|
|
14
14
|
* ответ упавшей копии ещё выглядит идущим: 15–20 с. Запрос дешёвый — по частичному индексу идущих ответов.
|
|
15
15
|
*/
|
|
16
16
|
export declare const STALE_ANSWERS_SWEEP_EVERY_MS = 5000;
|
|
@@ -22,7 +22,7 @@ existing?: AgentChatMessage,
|
|
|
22
22
|
/** Правка частей перед каждой записью (заголовки раздумий); сборка из кусков её не видит. */
|
|
23
23
|
decorateParts?: (parts: AgentChatMessage["parts"]) => AgentChatMessage["parts"]): {
|
|
24
24
|
observe(chunk: UIMessageChunk): void;
|
|
25
|
-
/**
|
|
25
|
+
/** Ждёт подтверждённую запись; сбой или остановка до неё — отказ, включая позднего ожидающего. */
|
|
26
26
|
whenCallSaved(toolCallId: string): Promise<void>;
|
|
27
27
|
/**
|
|
28
28
|
* Стирает части ответа с номера `keep`: сборка начинается заново с оставшихся, запись — сразу, без окна: упади
|
|
@@ -37,7 +37,7 @@ decorateParts?: (parts: AgentChatMessage["parts"]) => AgentChatMessage["parts"])
|
|
|
37
37
|
/** Части ответа со всеми уже поданными кусками: с них продолжает следующая попытка. */
|
|
38
38
|
snapshot(): Promise<AgentChatMessage["parts"]>;
|
|
39
39
|
/** Ждёт сборку и идущую запись; возвращает итоговые части — их запишет конечная запись хода. */
|
|
40
|
-
finish(): Promise<AgentChatMessage["parts"]>;
|
|
40
|
+
finish(lostOwnership?: AbortSignal): Promise<AgentChatMessage["parts"]>;
|
|
41
41
|
/** Ход кончился, в том числе исключением: таймеров записи и знака жизни больше нет. */
|
|
42
42
|
stop: () => void;
|
|
43
43
|
};
|
|
@@ -217,6 +217,8 @@ export interface AgentTurnInput {
|
|
|
217
217
|
tabId?: string;
|
|
218
218
|
};
|
|
219
219
|
abortSignal: AbortSignal;
|
|
220
|
+
/** Утрата поколения аренды отличается от остановки человеком: старый ход не завершает ответ записью. */
|
|
221
|
+
leaseSignal?: AbortSignal;
|
|
220
222
|
/**
|
|
221
223
|
* Продолжение ответа: новые куски дописываются в то же сообщение. После подтверждения `message` — сообщение
|
|
222
224
|
* с отмеченными решениями (уже в хранилище), `usage` — расход, накопленный до паузы. После «Повторить» `message` —
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { ToolSet } from "ai";
|
|
2
|
-
/**
|
|
2
|
+
/** Предел ожидания подтверждённой записи: по сроку — отказ, инструмент не выполняется. */
|
|
3
3
|
export declare const CALL_SAVE_WAIT_MS = 5000;
|
|
4
4
|
export interface ToolCallGate {
|
|
5
5
|
/** Шаг без инструментов (последний шаг хода, итог по потолку): вызов вопреки запрету не выполняется. */
|
|
@@ -17,6 +17,12 @@ export interface ChatTurnLeases {
|
|
|
17
17
|
enter(chatId: string, entering?: {
|
|
18
18
|
optional?: boolean;
|
|
19
19
|
}): Promise<boolean>;
|
|
20
|
+
/** Сигнал утраты текущей аренды; у хранилища без аренды его нет. */
|
|
21
|
+
signal(chatId: string): AbortSignal | undefined;
|
|
22
|
+
/** Неповторяющийся токен текущего поколения, для атомарной ограды записей. */
|
|
23
|
+
holder(chatId: string): string | undefined;
|
|
24
|
+
/** Отказ атомарной записи подтвердил утрату именно этого поколения аренды. */
|
|
25
|
+
invalidate(chatId: string, holder: string): void;
|
|
20
26
|
/** Конец занятости; последний выход снимает аренду. */
|
|
21
27
|
leave(chatId: string): void;
|
|
22
28
|
/** Остановка службы: снимает все аренды и ждёт, пока снятия дойдут до хранилища. */
|
|
@@ -32,4 +38,5 @@ export declare function createChatTurnLeases(input: {
|
|
|
32
38
|
storage: ChatStorage;
|
|
33
39
|
holder: string;
|
|
34
40
|
logError: (message: string) => void;
|
|
41
|
+
onLost?: (chatId: string) => void;
|
|
35
42
|
}): ChatTurnLeases;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { ChatStorage } from "./storage/chat-storage.js";
|
|
2
|
+
/** Права захвачены этим запуском, а не ищутся заново у позднего callback следующего хода. */
|
|
3
|
+
export declare function guardedTurnStorage(storage: ChatStorage, input: {
|
|
4
|
+
holder: string;
|
|
5
|
+
signal: AbortSignal;
|
|
6
|
+
onLost: () => void;
|
|
7
|
+
}): ChatStorage;
|
package/dist/types/index.d.ts
CHANGED
|
@@ -37,12 +37,12 @@ export { createDeepSeekProvider } from "./models/providers/deepseek.js";
|
|
|
37
37
|
export { createFireworksProvider } from "./models/providers/fireworks.js";
|
|
38
38
|
export { createTogetherProvider } from "./models/providers/together.js";
|
|
39
39
|
export type { OpenRouterMaxPrice, OpenRouterProviderOptions } from "./models/providers/openrouter.js";
|
|
40
|
-
export { aliveAtByLocalClock, assertKnownFormatVersion, ChatAlreadyExistsError, DuplicateChatSubjectError, DuplicateMessageError, MessageAlreadyFinishedError, MessageNotAwaitingError, RELEASED_ANSWER_ALIVE_AT, sameMessageParts, silenceBoundaryByLocalClock, UnsupportedFormatVersionError, } from "./storage/chat-storage.js";
|
|
40
|
+
export { aliveAtByLocalClock, assertKnownFormatVersion, ChatAlreadyExistsError, DuplicateChatSubjectError, DuplicateMessageError, ChatTurnLeaseLostError, MessageAlreadyFinishedError, MessageNotAwaitingError, RELEASED_ANSWER_ALIVE_AT, sameMessageParts, silenceBoundaryByLocalClock, UnsupportedFormatVersionError, } from "./storage/chat-storage.js";
|
|
41
41
|
export { assertChatData, assertChatDataFilter, CHAT_DATA_MAX_BYTES, ChatDataTooLargeError, chatDataFields, chatDataMatches, chatDataOfInput, mergeChatData } from "./storage/chat-data.js";
|
|
42
42
|
export type { ChatDataFilter, ChatDataFilterValue } from "./storage/chat-data.js";
|
|
43
43
|
export { migratePostgresSchema } from "./storage/postgres-migrations.js";
|
|
44
44
|
export type { PostgresMigrationConnection, PostgresMigrationOptions } from "./storage/postgres-migrations.js";
|
|
45
|
-
export type { AwaitingMessagePatch, ChatListOptions, ChatStorage, ChatSubjectFilter, FinishedMessagePatch, ImportedChat, MessageLink, MessagePartsLink, NewChatInput, SpendingLimitStateRecord, StoredPendingBurst, StreamingMessagePatch, } from "./storage/chat-storage.js";
|
|
45
|
+
export type { ChatTurnWriteGuard, AwaitingMessagePatch, ChatListOptions, ChatStorage, ChatSubjectFilter, FinishedMessagePatch, ImportedChat, MessageLink, MessagePartsLink, NewChatInput, SpendingLimitStateRecord, StoredPendingBurst, StreamingMessagePatch, } from "./storage/chat-storage.js";
|
|
46
46
|
export { SpendingLimitReachedError } from "./spending/spending-limits.js";
|
|
47
47
|
export { APP_EVENT_DATA_MAX_BYTES, APP_EVENT_TYPE_MAX_LENGTH, isTurnRefusalCode, normalizeTurnRefusal, TURN_REFUSAL_MESSAGE_MAX_LENGTH, TurnRefusedError, validateAppEvent, } from "./turn-hooks/turn-hooks.js";
|
|
48
48
|
export { DEFAULT_AFTER_TURN_ATTEMPTS, DEFAULT_AFTER_TURN_TIMEOUT_MS } from "./turn-hooks/after-turn.js";
|
|
@@ -11,7 +11,11 @@ export interface SpendingLimitStateRecord {
|
|
|
11
11
|
value: string;
|
|
12
12
|
version: number;
|
|
13
13
|
}
|
|
14
|
-
|
|
14
|
+
/** Условие записи ответа: тот же неповторяющийся держатель и ещё живая аренда чата, атомарно с записью. Не данные сообщения. */
|
|
15
|
+
export interface ChatTurnWriteGuard {
|
|
16
|
+
expectedTurnHolder?: string;
|
|
17
|
+
}
|
|
18
|
+
export type StreamingMessagePatch = Pick<StoredMessage, "parts"> & Partial<Pick<StoredMessage, "usage" | "reasoningDurationsMs" | "alive">> & ChatTurnWriteGuard;
|
|
15
19
|
/**
|
|
16
20
|
* `providerId` — только если ответил запасной провайдер, а не выбранный при вставке. `afterTurn` — состояние хука итога
|
|
17
21
|
* (обычно `pending`), ставится той же записью; хранилище без состояния хука его пропускает.
|
|
@@ -20,7 +24,7 @@ export type FinishedMessagePatch = {
|
|
|
20
24
|
status: FinalAnswerStatus;
|
|
21
25
|
} & Partial<Pick<StoredMessage, "parts" | "usage" | "reasoningDurationsMs" | "error" | "providerId">> & {
|
|
22
26
|
afterTurn?: AfterTurnState;
|
|
23
|
-
};
|
|
27
|
+
} & ChatTurnWriteGuard;
|
|
24
28
|
/** Новый чат. `createdAt` задан — и создание, и обновление чата получают эту дату; нет — время записи. */
|
|
25
29
|
export interface NewChatInput {
|
|
26
30
|
id: string;
|
|
@@ -53,7 +57,7 @@ export interface ChatListOptions {
|
|
|
53
57
|
/** Чат для переноса целиком: даты как есть. */
|
|
54
58
|
export type ImportedChat = Pick<Chat, "id" | "ownerId" | "modelId" | "providerId" | "createdAt" | "updatedAt"> & Partial<Pick<Chat, "reasoning" | "title" | "subjectKey" | "data" | "subjectData">>;
|
|
55
59
|
/** Правка ответа, который ждёт подтверждения: новые части и, если ожидание кончилось, новый статус. */
|
|
56
|
-
export interface AwaitingMessagePatch {
|
|
60
|
+
export interface AwaitingMessagePatch extends ChatTurnWriteGuard {
|
|
57
61
|
parts: StoredMessage["parts"];
|
|
58
62
|
/** Не указан — ответ остаётся ждущим. `streaming` — ход продолжается, `complete` — ожидание закрыто без продолжения. */
|
|
59
63
|
status?: "streaming" | "complete";
|
|
@@ -78,6 +82,8 @@ export interface MessagePartsLink extends MessageLink {
|
|
|
78
82
|
}
|
|
79
83
|
/** Хранилище чатов. Владельца не проверяет — это делает ядро до вызова. */
|
|
80
84
|
export interface ChatStorage {
|
|
85
|
+
/** Адаптер атомарно исполняет ChatTurnWriteGuard у всех записей ответа; обязателен при наличии аренд. */
|
|
86
|
+
readonly guardedTurnWrites?: true;
|
|
81
87
|
/** Повтор `subjectKey` у того же владельца — `DuplicateChatSubjectError`, чат не записан. */
|
|
82
88
|
createChat(input: NewChatInput): Promise<Chat>;
|
|
83
89
|
getChat(chatId: string): Promise<Chat | null>;
|
|
@@ -162,7 +168,7 @@ export interface ChatStorage {
|
|
|
162
168
|
*/
|
|
163
169
|
listMessagePartsOfTypes?(chatId: string, types: readonly string[]): Promise<MessagePartsLink[]>;
|
|
164
170
|
/** Новое сообщение; в той же операции обновляет `updatedAt` чата. */
|
|
165
|
-
insertMessage(message: StoredMessage): Promise<void>;
|
|
171
|
+
insertMessage(message: StoredMessage, guard?: ChatTurnWriteGuard): Promise<void>;
|
|
166
172
|
/** Дописать идущий ответ. Только пока status = 'streaming'. */
|
|
167
173
|
updateStreamingMessage(messageId: string, patch: StreamingMessagePatch): Promise<void>;
|
|
168
174
|
/**
|
|
@@ -170,7 +176,7 @@ export interface ChatStorage {
|
|
|
170
176
|
* status = 'streaming', иначе `MessageAlreadyFinishedError`. Необязательный: без него ход пишет знак полной записью
|
|
171
177
|
* ответа (`updateStreamingMessage`).
|
|
172
178
|
*/
|
|
173
|
-
markAnswerAlive?(messageId: string): Promise<void>;
|
|
179
|
+
markAnswerAlive?(messageId: string, guard?: ChatTurnWriteGuard): Promise<void>;
|
|
174
180
|
/** Перевести ответ в конечное состояние. Только из 'streaming'. */
|
|
175
181
|
finishMessage(messageId: string, final: FinishedMessagePatch): Promise<void>;
|
|
176
182
|
/**
|
|
@@ -390,6 +396,11 @@ export declare class DuplicateChatSubjectError extends Error {
|
|
|
390
396
|
readonly subjectKey: string;
|
|
391
397
|
constructor(ownerId: string, subjectKey: string);
|
|
392
398
|
}
|
|
399
|
+
/** Запись ответа отклонена: поколение аренды сменилось или её срок истёк. */
|
|
400
|
+
export declare class ChatTurnLeaseLostError extends Error {
|
|
401
|
+
readonly messageId: string;
|
|
402
|
+
constructor(messageId: string);
|
|
403
|
+
}
|
|
393
404
|
export declare class MessageAlreadyFinishedError extends Error {
|
|
394
405
|
constructor(messageId: string);
|
|
395
406
|
}
|