@ykurilov/agent-chat-server 0.105.1 → 0.106.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.
@@ -1,8 +1,11 @@
1
1
  import type { BrowserChatSnapshot, ChatHistory, InMemoryChatSnapshot } from "@ykurilov/agent-chat-core";
2
+ import type { BrowserChatUsage } from "./types.js";
2
3
  export interface BrowserChatPayload {
3
4
  version: 1;
4
5
  internalChatId: string;
5
6
  storage: InMemoryChatSnapshot;
7
+ /** Расход, который `onUsage` не принял: повторяется на следующем запросе, пока не примет. */
8
+ unbilled?: BrowserChatUsage[];
6
9
  }
7
10
  export declare function createBrowserChatCodec(keyInput: string | Uint8Array, namespace: string, maxBytes: number): {
8
11
  encode(ownerId: string, chatId: string, payload: BrowserChatPayload, history: ChatHistory): BrowserChatSnapshot;
@@ -1,5 +1,5 @@
1
1
  import type { AgentChannel, ChatEvent, ChatTurnTrigger, HiddenStateKey, TaskView } from "@ykurilov/agent-chat-core";
2
- /** Как часто поток сверяется с базой, пока у чата идут задачи. */
2
+ /** Как часто поток сверяется с базой: конец ветки — всегда, задачи — пока они идут. */
3
3
  export declare const WATCH_RECONCILE_EVERY_MS = 5000;
4
4
  /** Событие для вкладки: без владельца — он ей не нужен. */
5
5
  export type WatchEvent = ChatEvent extends infer Event ? (Event extends unknown ? Omit<Event, "ownerId"> : never) : never;
@@ -11,8 +11,13 @@ export interface WatchStreamOptions {
11
11
  subscribeEvents(listener: (event: ChatEvent) => void): () => void;
12
12
  /** Ключи состояния, которые не уходят вкладке в `state-changed`; нет — только служебные ключи SDK. */
13
13
  hiddenStateKey?: HiddenStateKey;
14
- /** Задачи чата; нет фона — сверки нет. */
14
+ /** Задачи чата; нет фона — задачи не сверяются. */
15
15
  listTasks?: () => Promise<TaskView[]>;
16
+ /**
17
+ * Id последнего сообщения текущей ветки в базе (`null` — сообщений нет). Сверяется раз в 5 с: так видны ход, сообщение
18
+ * и смена ветки, которые записала другая копия сервера (сообщение из мессенджера, вкладка на другой копии). Нет — не сверяется.
19
+ */
20
+ branchTail?: () => Promise<string | null>;
16
21
  /** Ход, ответ которого идёт в базе, но не на этой копии сервера, с источником и каналом по истории; нет — `null`. */
17
22
  detachedTurn(): Promise<{
18
23
  messageId: string;
@@ -23,7 +28,8 @@ export interface WatchStreamOptions {
23
28
  logError(message: string, error?: unknown): void;
24
29
  }
25
30
  /**
26
- * События одного чата: ход начался, ход закончился, задачи изменились. Пока у чата идут задачи, раз в 5 с поток
27
- * сверяется с базой: так видны ход и задачи, которые ведёт другая копия сервера.
31
+ * События одного чата: ход начался, ход закончился, задачи изменились. Раз в 5 с поток сверяется с базой: так видны ход,
32
+ * сообщения и задачи, которые ведёт другая копия сервера. Свои изменения этой копии приходят событиями сразу, сверка их
33
+ * не повторяет.
28
34
  */
29
35
  export declare function createWatchStream(options: WatchStreamOptions): ReadableStream<WatchEvent>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ykurilov/agent-chat-server",
3
- "version": "0.105.1",
3
+ "version": "0.106.0",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "dependencies": {
52
52
  "ai": "7.0.122",
53
- "@ykurilov/agent-chat-core": "0.105.1"
53
+ "@ykurilov/agent-chat-core": "0.106.0"
54
54
  },
55
55
  "peerDependencies": {
56
56
  "hono": "^4.13.10"