@ykurilov/agent-chat-core 0.98.0 → 0.99.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 +6 -0
- package/dist/{chunk-N4BEH2WJ.js → chunk-5ABNI4QD.js} +54 -8
- package/dist/chunk-5ABNI4QD.js.map +1 -0
- package/dist/index.js +30 -1
- package/dist/index.js.map +1 -1
- package/dist/storage-contract.js +1 -1
- package/dist/types/agent-run/answer-saver.d.ts +3 -4
- package/dist/types/agent-run/run-agent-turn.d.ts +1 -0
- package/dist/types/conversation/browser-chat.d.ts +19 -0
- package/dist/types/index.d.ts +4 -0
- package/dist/types/storage/in-memory-storage.d.ts +16 -0
- package/dist/types/transient-chat.d.ts +6 -0
- package/package.json +1 -1
- package/dist/chunk-N4BEH2WJ.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# @ykurilov/agent-chat-core
|
|
2
2
|
|
|
3
|
+
## 0.99.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 5e688b2: Добавлен opt-in чат с историей только в браузере: отдельный createBrowserChatHandler создаёт RAM-хранилище на запрос, а createBrowserChatTransport сохраняет owner-bound шифрованный снимок до показа потока. Обычный AgentChat/Одуванчик поддерживает текст, модели, Stop, ветки и серверные инструменты. После reload/обрыва показанный текст остаётся; продолжение явное. Обычные серверные чаты и idle watch по умолчанию не меняются.
|
|
8
|
+
|
|
9
|
+
### Как обновить приложение
|
|
10
|
+
|
|
11
|
+
Подключите createBrowserChatHandler из @ykurilov/agent-chat-server к отдельному POST endpoint, с resolveUser, серверными catalog/agent, постоянными namespace и snapshotKey (32 случайных байта). createBrowserChatTransport из @ykurilov/agent-chat-react получает endpoint/ownerId/chatId/loadSnapshot/saveSnapshot; передайте его chatProps в обычный AgentChat, вызывайте dispose при замене. Приложение сохраняет весь снимок атомарно в IndexedDB с revision guards. Не подключайте обычные attachments/voice/subject/appBridge: первая версия без файлов, голоса, памяти, helpers, widgets, browser RPC, фона и approval-инструментов. Биллинг/лимиты между запросами — внешние numeric callbacks, не transient ledger. Контракт и ограничения: docs/browser-owned-chat.md. Старым приложениям менять подключение не требуется.
|
|
12
|
+
|
|
13
|
+
## 0.98.1
|
|
14
|
+
|
|
15
|
+
No changes in this release.
|
|
16
|
+
|
|
3
17
|
## 0.98.0
|
|
4
18
|
|
|
5
19
|
No changes in this release.
|
package/README.md
CHANGED
|
@@ -175,3 +175,9 @@ docs/getting-started.md, «Значки шагов и заголовки раз
|
|
|
175
175
|
### Правка ответа в обычном чате (с 0.97.0)
|
|
176
176
|
|
|
177
177
|
Серверный `answerEditing: true` и право `chatCapabilities.answerEditing` включают адрес правки ответа для Next/Hono. В `AgentChat` со скином «Одуванчик» передайте `answerEditor={true}` либо объект с `renderFields({ data, setData, disabled, message })` для своих полей. `onAnswerEdited` получает id исходного и нового ответа, оба текста, владельца, чат и JSON `data` приложения. Прежний пользовательский `answerEditing={{ edits, renderEditor }}` совместим и имеет приоритет. [Контракт, пределы доставки хука и обновление приложения](../../docs/answer-editing.md).
|
|
178
|
+
|
|
179
|
+
## Transient-снимок
|
|
180
|
+
|
|
181
|
+
Серверный `createTransientChatStorage(snapshot?)` экспортирует копию истории, веток, сжатия и числового расхода через `exportSnapshot()`. Живые аренды, знаки жизни и долговременная память не переносятся. Конструктор принимает **только доверенный серверный** `InMemoryChatSnapshot`, не JSON от браузера. Для публичного HTTP используйте `createBrowserChatHandler` сервера с проверкой владельца и seal. `createInMemoryChatStorage()` сохраняет старый контракт.
|
|
182
|
+
|
|
183
|
+
`checkpointTransientChat(service)` сохраняет текущую сборку без остановки хода; `getTransientChatHistory(service,userId,chatId)` ждёт checkpoint и отдаёт обычную проекцию прав видимости вместе с активным ответом. Обычный getHistory не меняется. [Режим browser-owned](../../docs/browser-owned-chat.md).
|
|
@@ -6098,10 +6098,14 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
|
|
|
6098
6098
|
await current;
|
|
6099
6099
|
return latest;
|
|
6100
6100
|
},
|
|
6101
|
-
/**
|
|
6102
|
-
|
|
6103
|
-
|
|
6104
|
-
|
|
6101
|
+
/** Сохраняет принятую сборку до контрольной метки, не останавливая запись и знак жизни. */
|
|
6102
|
+
async checkpoint() {
|
|
6103
|
+
await rewinding?.catch(() => {
|
|
6104
|
+
});
|
|
6105
|
+
await settleAssembly();
|
|
6106
|
+
await writeNow();
|
|
6107
|
+
},
|
|
6108
|
+
/** Штатная остановка: пишет остаток и освобождает ответ для восстановления без порога тишины. */
|
|
6105
6109
|
async flush() {
|
|
6106
6110
|
released = true;
|
|
6107
6111
|
clearTimeout(aliveTimer);
|
|
@@ -7271,6 +7275,16 @@ async function runTurn(turnInput, emitRaw) {
|
|
|
7271
7275
|
emitToClient({ type: "message-metadata", messageMetadata: metadata });
|
|
7272
7276
|
};
|
|
7273
7277
|
input.flushers?.add(saver.flush);
|
|
7278
|
+
let finalizingSnapshot = false;
|
|
7279
|
+
let finishSnapshot;
|
|
7280
|
+
const snapshotFinished = new Promise((resolve) => {
|
|
7281
|
+
finishSnapshot = resolve;
|
|
7282
|
+
});
|
|
7283
|
+
const checkpoint = async () => {
|
|
7284
|
+
await saver.checkpoint();
|
|
7285
|
+
if (finalizingSnapshot) await snapshotFinished;
|
|
7286
|
+
};
|
|
7287
|
+
input.checkpointers?.add(checkpoint);
|
|
7274
7288
|
try {
|
|
7275
7289
|
const maxSteps = input.maxSteps ?? DEFAULT_MAX_STEPS;
|
|
7276
7290
|
let stepsDone = 0;
|
|
@@ -7680,6 +7694,7 @@ async function runTurn(turnInput, emitRaw) {
|
|
|
7680
7694
|
const closure = chatClosure.close();
|
|
7681
7695
|
browser?.close();
|
|
7682
7696
|
input.flushers?.delete(saver.flush);
|
|
7697
|
+
finalizingSnapshot = true;
|
|
7683
7698
|
if (thoughtTitles) {
|
|
7684
7699
|
if (!input.abortSignal.aborted && errors.length === 0) await thoughtTitles.settle(input.thoughtTitles.settleMs ?? THOUGHT_TITLES_SETTLE_MS);
|
|
7685
7700
|
thoughtTitles.close();
|
|
@@ -7862,6 +7877,8 @@ async function runTurn(turnInput, emitRaw) {
|
|
|
7862
7877
|
input.leaseSignal?.removeEventListener("abort", onLeaseLost);
|
|
7863
7878
|
thoughtTitles?.close();
|
|
7864
7879
|
input.flushers?.delete(saver.flush);
|
|
7880
|
+
input.checkpointers?.delete(checkpoint);
|
|
7881
|
+
finishSnapshot();
|
|
7865
7882
|
}
|
|
7866
7883
|
}
|
|
7867
7884
|
function replayCopiedParts(message, emitToClient) {
|
|
@@ -10524,6 +10541,27 @@ function createRunningAnswerRegistry() {
|
|
|
10524
10541
|
};
|
|
10525
10542
|
}
|
|
10526
10543
|
|
|
10544
|
+
// src/transient-chat.ts
|
|
10545
|
+
var checkpoints = /* @__PURE__ */ new WeakMap();
|
|
10546
|
+
function registerTransientCheckpoint(service, checkpoint) {
|
|
10547
|
+
checkpoints.set(service, checkpoint);
|
|
10548
|
+
}
|
|
10549
|
+
async function checkpointTransientChat(service) {
|
|
10550
|
+
const checkpoint = checkpoints.get(service);
|
|
10551
|
+
if (!checkpoint) throw new TypeError("Transient checkpoint is unavailable for this service");
|
|
10552
|
+
await checkpoint();
|
|
10553
|
+
}
|
|
10554
|
+
var histories = /* @__PURE__ */ new WeakMap();
|
|
10555
|
+
function registerTransientHistory(service, history) {
|
|
10556
|
+
histories.set(service, history);
|
|
10557
|
+
}
|
|
10558
|
+
async function getTransientChatHistory(service, userId, chatId) {
|
|
10559
|
+
const history = histories.get(service);
|
|
10560
|
+
if (!history) throw new TypeError("Transient history is unavailable for this service");
|
|
10561
|
+
await checkpointTransientChat(service);
|
|
10562
|
+
return history(userId, chatId);
|
|
10563
|
+
}
|
|
10564
|
+
|
|
10527
10565
|
// src/voice-tags.ts
|
|
10528
10566
|
var MIN_LETTERS = 3;
|
|
10529
10567
|
var MAX_LENGTH = 40;
|
|
@@ -13323,6 +13361,7 @@ function createChatService(input) {
|
|
|
13323
13361
|
const writingUndelivered = /* @__PURE__ */ new Set();
|
|
13324
13362
|
const afterTurnWork = /* @__PURE__ */ new Set();
|
|
13325
13363
|
const flushers = /* @__PURE__ */ new Set();
|
|
13364
|
+
const checkpointers = /* @__PURE__ */ new Set();
|
|
13326
13365
|
const liveAnswerIds = /* @__PURE__ */ new Set();
|
|
13327
13366
|
const steering = createTurnSteering();
|
|
13328
13367
|
const handOffs = /* @__PURE__ */ new Map();
|
|
@@ -13750,7 +13789,7 @@ function createChatService(input) {
|
|
|
13750
13789
|
async function choiceForNewChat(userId) {
|
|
13751
13790
|
return await rememberedChoice(userId) ?? defaultChoice;
|
|
13752
13791
|
}
|
|
13753
|
-
async function historyOf(userId, chatId, { write, scope }) {
|
|
13792
|
+
async function historyOf(userId, chatId, { write, scope, includeRunning }) {
|
|
13754
13793
|
const stored = await ownChat(userId, chatId);
|
|
13755
13794
|
const runningId = registry.runningMessageId(chatId);
|
|
13756
13795
|
let { messages, selections, branch } = await loadTree(chatId);
|
|
@@ -13782,7 +13821,7 @@ function createChatService(input) {
|
|
|
13782
13821
|
// Служебные и закрытые ключи состояния и служебные сообщения в браузер не уходят (FR-003).
|
|
13783
13822
|
messages: visible(
|
|
13784
13823
|
publicMessages(
|
|
13785
|
-
shown.filter((message) => message.id !== runningAnswerId || resumeBases.get(chatId)?.id === runningAnswerId).map((message) => message.id === runningAnswerId ? resumeBases.get(chatId) : markedUndelivered(toAgentChatMessage(message))),
|
|
13824
|
+
shown.filter((message) => includeRunning || message.id !== runningAnswerId || resumeBases.get(chatId)?.id === runningAnswerId).map((message) => message.id === runningAnswerId && !includeRunning ? resumeBases.get(chatId) : markedUndelivered(toAgentChatMessage(message))),
|
|
13786
13825
|
hiddenStateKey,
|
|
13787
13826
|
screenNotices
|
|
13788
13827
|
)
|
|
@@ -14183,7 +14222,8 @@ function createChatService(input) {
|
|
|
14183
14222
|
},
|
|
14184
14223
|
createdAt: launch.createdAt,
|
|
14185
14224
|
logError,
|
|
14186
|
-
flushers
|
|
14225
|
+
flushers,
|
|
14226
|
+
checkpointers
|
|
14187
14227
|
});
|
|
14188
14228
|
});
|
|
14189
14229
|
} catch (error) {
|
|
@@ -15477,6 +15517,10 @@ function createChatService(input) {
|
|
|
15477
15517
|
});
|
|
15478
15518
|
if (storage.listSilentAnswerIds) startStaleSweep();
|
|
15479
15519
|
else logError("\u0410\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u043E\u0435 \u0432\u043E\u0441\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0435 \u043E\u0442\u0432\u0435\u0442\u043E\u0432 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u043D\u043E: \u0443 \u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0430 \u043D\u0435\u0442 listSilentAnswerIds. \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u0435 \u0430\u0434\u0430\u043F\u0442\u0435\u0440; \u0434\u043B\u044F \u0435\u0434\u0438\u043D\u0441\u0442\u0432\u0435\u043D\u043D\u043E\u0439 \u043A\u043E\u043F\u0438\u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u044F\u0432\u043D\u043E \u0432\u044B\u0437\u043E\u0432\u0438\u0442\u0435 recoverInterruptedAnswers \u043F\u0440\u0438 \u0437\u0430\u043F\u0443\u0441\u043A\u0435.");
|
|
15520
|
+
registerTransientHistory(service, (userId, chatId) => historyOf(userId, chatId, { write: true, includeRunning: true }));
|
|
15521
|
+
registerTransientCheckpoint(service, async () => {
|
|
15522
|
+
await Promise.all([...checkpointers].map((checkpoint) => checkpoint()));
|
|
15523
|
+
});
|
|
15480
15524
|
return service;
|
|
15481
15525
|
function isDetachedAnswer(last, runningId) {
|
|
15482
15526
|
return runningId === null && last?.status === "streaming" && !liveAnswerIds.has(last.id);
|
|
@@ -15724,6 +15768,8 @@ export {
|
|
|
15724
15768
|
TooManyTurnsError,
|
|
15725
15769
|
ChatBusyError,
|
|
15726
15770
|
createRunningAnswerRegistry,
|
|
15771
|
+
checkpointTransientChat,
|
|
15772
|
+
getTransientChatHistory,
|
|
15727
15773
|
splitVoiceTags,
|
|
15728
15774
|
stripVoiceTags,
|
|
15729
15775
|
VOICE_TAGS,
|
|
@@ -15760,4 +15806,4 @@ export {
|
|
|
15760
15806
|
InvalidWidgetAnswerError,
|
|
15761
15807
|
createChatService
|
|
15762
15808
|
};
|
|
15763
|
-
//# sourceMappingURL=chunk-
|
|
15809
|
+
//# sourceMappingURL=chunk-5ABNI4QD.js.map
|