@ykurilov/agent-chat-core 0.100.0 → 0.101.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 +14 -0
- package/README.md +1 -1
- package/dist/{chunk-YVM6GGKN.js → chunk-ITXLUAPJ.js} +52 -2
- package/dist/chunk-ITXLUAPJ.js.map +1 -0
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/storage-contract.js +36 -1
- package/dist/storage-contract.js.map +1 -1
- package/dist/types/chat-events/chat-events.d.ts +10 -0
- package/dist/types/chat-service.d.ts +11 -0
- package/dist/types/index.d.ts +2 -0
- package/dist/types/storage/chat-storage.d.ts +9 -0
- package/dist/types/storage/storage-contract.d.ts +2 -0
- package/dist/types/subject-chats/greeting-replacement.d.ts +66 -0
- package/dist/types/subject-chats/subject-chats.d.ts +5 -0
- package/dist/types/usage/cache-miss-watch.d.ts +2 -0
- package/package.json +1 -1
- package/dist/chunk-YVM6GGKN.js.map +0 -1
|
@@ -70,6 +70,16 @@ export type ChatEvent = {
|
|
|
70
70
|
chatId: string;
|
|
71
71
|
messageId: string;
|
|
72
72
|
}
|
|
73
|
+
/**
|
|
74
|
+
* Текст приветствия заменён (`replaceGreeting`): то же сообщение `messageId`, новый текст. Вкладке пора перечитать
|
|
75
|
+
* историю. Клиенты до 0.101.0 такое событие пропускают и видят новый текст при следующем чтении истории.
|
|
76
|
+
*/
|
|
77
|
+
| {
|
|
78
|
+
type: "greeting-replaced";
|
|
79
|
+
ownerId: string;
|
|
80
|
+
chatId: string;
|
|
81
|
+
messageId: string;
|
|
82
|
+
}
|
|
73
83
|
/**
|
|
74
84
|
* Данные чата изменены (`service.updateChatData`). Самих данных в событии нет, вкладке оно не пересылается: данные
|
|
75
85
|
* чата остаются на сервере. Новое значение видят инструменты и хуки со следующего хода.
|
|
@@ -26,6 +26,7 @@ import type { AgentHelper } from "./helpers/helper-types.js";
|
|
|
26
26
|
import type { LongTermMemory } from "./memory/long-term-memory.js";
|
|
27
27
|
import type { CompactionMarker, CompactionOutcome } from "./compaction/compaction-service.js";
|
|
28
28
|
import type { CompactionSettings } from "./compaction/compaction-settings.js";
|
|
29
|
+
import type { ReplaceGreetingInput, ReplaceGreetingResult } from "./subject-chats/greeting-replacement.js";
|
|
29
30
|
import type { ChatGreeting, ImportChatInput, OpenSubjectChatInput, OpenSubjectChatResult } from "./subject-chats/subject-chats.js";
|
|
30
31
|
import type { AppStateValues } from "./app-state/app-state.js";
|
|
31
32
|
import type { ChatImageReference } from "./attachments/chat-image-numbers.js";
|
|
@@ -738,6 +739,16 @@ export interface ChatService {
|
|
|
738
739
|
* @throws Error хранилище не умеет `updateChatData`.
|
|
739
740
|
*/
|
|
740
741
|
updateChatData(userId: string, chatId: string, patch: Record<string, unknown>): Promise<Record<string, unknown>>;
|
|
742
|
+
/**
|
|
743
|
+
* Замена текста приветствия (`greeting.text`) в уже созданном чате; вся переписка после него не меняется. Меняется
|
|
744
|
+
* только сообщение, которое точно приветствие (`findGreeting`): иначе — `not_a_greeting` без записи. Тот же текст —
|
|
745
|
+
* `unchanged`, `dryRun` — итог без записи. Идёт ход — `busy`, ничего не записано. Открытые вкладки получают событие
|
|
746
|
+
* `greeting-replaced` и перечитывают историю. Модель видит новый текст со следующего хода; приветствие внутри сводки
|
|
747
|
+
* автосжатия (`compacted: true`) модель видит сводкой. Кэш модели после замены один раз прочитывается заново.
|
|
748
|
+
* @throws TypeError текст не строка от 1 до 10 000 знаков.
|
|
749
|
+
* @throws Error хранилище не умеет `replaceFinishedMessageParts`.
|
|
750
|
+
*/
|
|
751
|
+
replaceGreeting(input: ReplaceGreetingInput): Promise<ReplaceGreetingResult>;
|
|
741
752
|
/**
|
|
742
753
|
* Данные чата копией, без записи и событий: те же проверки владения, что у `updateChatData`. Нет данных — `{}`.
|
|
743
754
|
* @throws ChatNotFoundError чата нет или он чужой.
|
package/dist/types/index.d.ts
CHANGED
|
@@ -88,6 +88,8 @@ export { BURST_HOLD_MS, BURST_PART_TYPE, BURST_SWEEP_LIMIT, DEFAULT_BURST_QUIET_
|
|
|
88
88
|
export { GREETING_LEAD } from "./agent-run/greeting-lead.js";
|
|
89
89
|
export { GREETING_MAX_LENGTH, IMPORT_MAX_IMAGE_BYTES, IMPORT_MAX_IMAGES, IMPORT_MAX_MESSAGES, SUBJECT_DATA_MAX_BYTES, SUBJECT_KEY_MAX_LENGTH } from "./subject-chats/subject-chats.js";
|
|
90
90
|
export type { ChatGreeting, ImportChatInput, ImportedImagePart, ImportedMessageInput, OpenSubjectChatInput, OpenSubjectChatResult, } from "./subject-chats/subject-chats.js";
|
|
91
|
+
export { GREETING_ID_PREFIX } from "./subject-chats/greeting-replacement.js";
|
|
92
|
+
export type { GreetingRecognition, NotAGreetingReason, ReplaceGreetingInput, ReplaceGreetingResult } from "./subject-chats/greeting-replacement.js";
|
|
91
93
|
export { AttachmentRejectedError, withoutFileParts } from "./attachments/message-attachments.js";
|
|
92
94
|
export type { IncomingFilePart, MessageAttachments, StoredFilePart } from "./attachments/message-attachments.js";
|
|
93
95
|
export type { ChatImageReference } from "./attachments/chat-image-numbers.js";
|
|
@@ -186,6 +186,15 @@ export interface ChatStorage {
|
|
|
186
186
|
* теми же частями; иначе `MessageNotAwaitingError`.
|
|
187
187
|
*/
|
|
188
188
|
updateAwaitingMessage(messageId: string, patch: AwaitingMessagePatch): Promise<void>;
|
|
189
|
+
/**
|
|
190
|
+
* Новые части готового (`complete`) сообщения, если в базе сейчас ровно `expectedParts` (порядок ключей не важен):
|
|
191
|
+
* сравнение и запись — одним шагом. Остальные поля сообщения и чата (в том числе `updatedAt`) не меняются. Записано —
|
|
192
|
+
* `true`; сообщения нет, оно не готово или части уже другие — `false`, ничего не записано. Нужен `replaceGreeting`.
|
|
193
|
+
*/
|
|
194
|
+
replaceFinishedMessageParts?(messageId: string, replace: {
|
|
195
|
+
expectedParts: StoredMessage["parts"];
|
|
196
|
+
parts: StoredMessage["parts"];
|
|
197
|
+
}): Promise<boolean>;
|
|
189
198
|
/** Все ответы в состоянии 'streaming'. */
|
|
190
199
|
listStreamingMessageIds(): Promise<string[]>;
|
|
191
200
|
/**
|
|
@@ -38,4 +38,6 @@ export declare function describeChatStorageContract(createStorage: () => ChatSto
|
|
|
38
38
|
* `removePendingBurst`) обязаны быть.
|
|
39
39
|
*/
|
|
40
40
|
pendingBursts?: "required";
|
|
41
|
+
/** `finishedPartsReplace: "required"` — замена частей готового сообщения (`replaceFinishedMessageParts`) обязана быть. */
|
|
42
|
+
finishedPartsReplace?: "required";
|
|
41
43
|
}): void;
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { Chat, StoredMessage } from "../conversation/types.js";
|
|
2
|
+
/**
|
|
3
|
+
* Начало id приветствия (`greeting.text`), записанного SDK с 0.101.0: метка, по которой `replaceGreeting` узнаёт его без
|
|
4
|
+
* догадок. Приветствия старых версий — с обычным UUID; их узнают строгие признаки (`findGreeting`).
|
|
5
|
+
*/
|
|
6
|
+
export declare const GREETING_ID_PREFIX = "greeting-";
|
|
7
|
+
export interface ReplaceGreetingInput {
|
|
8
|
+
ownerId: string;
|
|
9
|
+
chatId: string;
|
|
10
|
+
/** Новый текст приветствия, 1–10 000 знаков, как `greeting.text`. */
|
|
11
|
+
text: string;
|
|
12
|
+
/**
|
|
13
|
+
* Текущий текст приветствия, каким его ждёт приложение. Есть и не совпал — `not_a_greeting`
|
|
14
|
+
* (`previous_text_mismatch`), ничего не записано. Страховка для старых чатов без метки.
|
|
15
|
+
*/
|
|
16
|
+
previousText?: string;
|
|
17
|
+
/** Пробный прогон: те же проверки и итог (`would_replace` вместо `replaced`), без записи и события. */
|
|
18
|
+
dryRun?: boolean;
|
|
19
|
+
}
|
|
20
|
+
/** Как узнано приветствие: по метке в id (`marker`) или, у чатов старых версий, по строгим признакам (`signs`). */
|
|
21
|
+
export type GreetingRecognition = "marker" | "signs";
|
|
22
|
+
export type NotAGreetingReason = "empty_chat" | "first_message_not_greeting" | "previous_text_mismatch";
|
|
23
|
+
export type ReplaceGreetingResult = {
|
|
24
|
+
status: "replaced" | "would_replace";
|
|
25
|
+
chatId: string;
|
|
26
|
+
messageId: string;
|
|
27
|
+
previousText: string;
|
|
28
|
+
recognizedBy: GreetingRecognition;
|
|
29
|
+
/** Приветствие внутри сводки автосжатия: модель видит сводку, а не новый текст. Экран показывает новый текст. */
|
|
30
|
+
compacted: boolean;
|
|
31
|
+
} | {
|
|
32
|
+
status: "unchanged";
|
|
33
|
+
chatId: string;
|
|
34
|
+
messageId: string;
|
|
35
|
+
recognizedBy: GreetingRecognition;
|
|
36
|
+
compacted: boolean;
|
|
37
|
+
} | {
|
|
38
|
+
status: "not_a_greeting";
|
|
39
|
+
chatId: string;
|
|
40
|
+
reason: NotAGreetingReason;
|
|
41
|
+
}
|
|
42
|
+
/** Чата нет или он чужой. */
|
|
43
|
+
| {
|
|
44
|
+
status: "chat_not_found";
|
|
45
|
+
chatId: string;
|
|
46
|
+
}
|
|
47
|
+
/** В чате идёт ход (здесь или на другой копии сервера): ничего не записано, повторить позже. */
|
|
48
|
+
| {
|
|
49
|
+
status: "busy";
|
|
50
|
+
chatId: string;
|
|
51
|
+
};
|
|
52
|
+
export type FoundGreeting = {
|
|
53
|
+
ok: true;
|
|
54
|
+
message: StoredMessage;
|
|
55
|
+
text: string;
|
|
56
|
+
recognizedBy: GreetingRecognition;
|
|
57
|
+
} | {
|
|
58
|
+
ok: false;
|
|
59
|
+
reason: Exclude<NotAGreetingReason, "previous_text_mismatch">;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Приветствие чата — первое сообщение текущей ветки, и только если это точно оно: законченный ответ агента в корне,
|
|
63
|
+
* ровно одна текстовая часть, без модели, провайдера, расхода и ошибки. С меткой в id этого достаточно. Без метки (чаты
|
|
64
|
+
* старых версий) ещё и дата сообщения равна дате чата, и других корневых сообщений в чате нет.
|
|
65
|
+
*/
|
|
66
|
+
export declare function findGreeting(chat: Pick<Chat, "createdAt">, messages: readonly StoredMessage[], branch: readonly StoredMessage[]): FoundGreeting;
|
|
@@ -121,3 +121,8 @@ export declare function createSubjectChats(deps: SubjectChatsDeps): {
|
|
|
121
121
|
};
|
|
122
122
|
/** Чат для браузера: данные чата и объекта остаются на сервере. */
|
|
123
123
|
export declare function withoutSubjectData(chat: Chat): Chat;
|
|
124
|
+
export declare function assertGreeting(greeting: ChatGreeting): asserts greeting is {
|
|
125
|
+
text: string;
|
|
126
|
+
} | {
|
|
127
|
+
instruction: string;
|
|
128
|
+
};
|
|
@@ -34,6 +34,8 @@ export interface CacheMissWatch {
|
|
|
34
34
|
forRequest(request: WatchedRequest): {
|
|
35
35
|
onStep(usage: WatchedStepUsage): void;
|
|
36
36
|
};
|
|
37
|
+
/** Начало истории чата законно переписано (замена приветствия): следующий запрос чата сравнивать не с чем. */
|
|
38
|
+
forget(chatId: string): void;
|
|
37
39
|
}
|
|
38
40
|
export interface CacheMissWatchOptions {
|
|
39
41
|
logError: (message: string, error?: unknown) => void;
|