@agentshouse/mdruntime 0.1.0-ce531b51ff088 → 0.1.0-ce6bc9239a3ee

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.
Files changed (253) hide show
  1. package/README.md +25 -12
  2. package/dist/acceptance.d.ts +26 -0
  3. package/dist/acceptance.d.ts.map +1 -0
  4. package/dist/acceptance.js +384 -0
  5. package/dist/adapter.d.ts +218 -62
  6. package/dist/adapter.d.ts.map +1 -1
  7. package/dist/adapter.js +1 -9
  8. package/dist/attached-model.d.ts +8 -0
  9. package/dist/attached-model.d.ts.map +1 -0
  10. package/dist/attached-model.js +46 -0
  11. package/dist/attempt.d.ts +16 -0
  12. package/dist/attempt.d.ts.map +1 -0
  13. package/dist/attempt.js +70 -0
  14. package/dist/binary.d.ts +18 -0
  15. package/dist/binary.d.ts.map +1 -0
  16. package/dist/binary.js +8 -0
  17. package/dist/bootstrap.d.ts +40 -6
  18. package/dist/bootstrap.d.ts.map +1 -1
  19. package/dist/bootstrap.js +336 -51
  20. package/dist/chain.d.ts +12 -0
  21. package/dist/chain.d.ts.map +1 -0
  22. package/dist/chain.js +64 -0
  23. package/dist/change-set.d.ts +9 -14
  24. package/dist/change-set.d.ts.map +1 -1
  25. package/dist/change-set.js +11 -56
  26. package/dist/change.d.ts +46 -0
  27. package/dist/change.d.ts.map +1 -1
  28. package/dist/change.js +34 -0
  29. package/dist/chat-types.d.ts +3 -0
  30. package/dist/chat-types.d.ts.map +1 -0
  31. package/dist/chat-types.js +2 -0
  32. package/dist/client.d.ts +50 -18
  33. package/dist/client.d.ts.map +1 -1
  34. package/dist/client.js +162 -30
  35. package/dist/collection.d.ts +13 -14
  36. package/dist/collection.d.ts.map +1 -1
  37. package/dist/collection.js +52 -56
  38. package/dist/compile.d.ts +16 -0
  39. package/dist/compile.d.ts.map +1 -0
  40. package/dist/compile.js +717 -0
  41. package/dist/connection.d.ts +63 -48
  42. package/dist/connection.d.ts.map +1 -1
  43. package/dist/connection.js +2487 -1575
  44. package/dist/context.d.ts +2 -0
  45. package/dist/context.d.ts.map +1 -0
  46. package/dist/context.js +7 -0
  47. package/dist/conversation-row.d.ts +33 -0
  48. package/dist/conversation-row.d.ts.map +1 -0
  49. package/dist/conversation-row.js +47 -0
  50. package/dist/conversation.d.ts +72 -22
  51. package/dist/conversation.d.ts.map +1 -1
  52. package/dist/conversation.js +1008 -273
  53. package/dist/digest.d.ts +7 -0
  54. package/dist/digest.d.ts.map +1 -0
  55. package/dist/digest.js +113 -0
  56. package/dist/durability.d.ts +10 -1
  57. package/dist/durability.d.ts.map +1 -1
  58. package/dist/durability.js +5 -0
  59. package/dist/entry.d.ts +20 -0
  60. package/dist/entry.d.ts.map +1 -0
  61. package/dist/entry.js +161 -0
  62. package/dist/expectation.d.ts +21 -0
  63. package/dist/expectation.d.ts.map +1 -0
  64. package/dist/expectation.js +70 -0
  65. package/dist/failure.d.ts +13 -0
  66. package/dist/failure.d.ts.map +1 -0
  67. package/dist/failure.js +19 -0
  68. package/dist/figures.d.ts +48 -0
  69. package/dist/figures.d.ts.map +1 -0
  70. package/dist/figures.js +197 -0
  71. package/dist/file.d.ts +2 -19
  72. package/dist/file.d.ts.map +1 -1
  73. package/dist/file.js +7 -122
  74. package/dist/host.d.ts +18 -2
  75. package/dist/host.d.ts.map +1 -1
  76. package/dist/host.js +164 -50
  77. package/dist/identity.d.ts +3 -0
  78. package/dist/identity.d.ts.map +1 -1
  79. package/dist/identity.js +13 -1
  80. package/dist/index.d.ts +31 -10
  81. package/dist/index.d.ts.map +1 -1
  82. package/dist/index.js +13 -0
  83. package/dist/install.d.ts +86 -0
  84. package/dist/install.d.ts.map +1 -0
  85. package/dist/install.js +537 -0
  86. package/dist/job.d.ts +33 -0
  87. package/dist/job.d.ts.map +1 -0
  88. package/dist/job.js +54 -0
  89. package/dist/live.d.ts +23 -0
  90. package/dist/live.d.ts.map +1 -0
  91. package/dist/live.js +165 -0
  92. package/dist/log.d.ts +1 -0
  93. package/dist/log.d.ts.map +1 -1
  94. package/dist/media.d.ts +8 -0
  95. package/dist/media.d.ts.map +1 -0
  96. package/dist/media.js +218 -0
  97. package/dist/memory.d.ts +30 -9
  98. package/dist/memory.d.ts.map +1 -1
  99. package/dist/memory.js +337 -86
  100. package/dist/messages.d.ts +52 -0
  101. package/dist/messages.d.ts.map +1 -0
  102. package/dist/messages.js +168 -0
  103. package/dist/model.d.ts +17 -16
  104. package/dist/model.d.ts.map +1 -1
  105. package/dist/model.js +9 -9
  106. package/dist/name.d.ts +4 -0
  107. package/dist/name.d.ts.map +1 -0
  108. package/dist/name.js +122 -0
  109. package/dist/observation.d.ts +22 -2
  110. package/dist/observation.d.ts.map +1 -1
  111. package/dist/observation.js +133 -17
  112. package/dist/open.d.ts +2 -0
  113. package/dist/open.d.ts.map +1 -0
  114. package/dist/open.js +1 -0
  115. package/dist/opened.d.ts +22 -0
  116. package/dist/opened.d.ts.map +1 -0
  117. package/dist/opened.js +107 -0
  118. package/dist/outcome.d.ts +73 -5
  119. package/dist/outcome.d.ts.map +1 -1
  120. package/dist/outcome.js +84 -1
  121. package/dist/overlay.d.ts +16 -5
  122. package/dist/overlay.d.ts.map +1 -1
  123. package/dist/overlay.js +147 -180
  124. package/dist/parts.d.ts +59 -0
  125. package/dist/parts.d.ts.map +1 -0
  126. package/dist/parts.js +118 -0
  127. package/dist/paths.d.ts +1 -1
  128. package/dist/paths.d.ts.map +1 -1
  129. package/dist/paths.js +4 -16
  130. package/dist/query.d.ts +56 -180
  131. package/dist/query.d.ts.map +1 -1
  132. package/dist/query.js +3 -422
  133. package/dist/questions.d.ts +32 -0
  134. package/dist/questions.d.ts.map +1 -0
  135. package/dist/questions.js +118 -0
  136. package/dist/reach.d.ts +54 -0
  137. package/dist/reach.d.ts.map +1 -0
  138. package/dist/reach.js +494 -0
  139. package/dist/react.d.ts +46 -0
  140. package/dist/react.d.ts.map +1 -0
  141. package/dist/react.js +54 -0
  142. package/dist/read.d.ts +7 -0
  143. package/dist/read.d.ts.map +1 -0
  144. package/dist/read.js +17 -0
  145. package/dist/readiness.d.ts +50 -0
  146. package/dist/readiness.d.ts.map +1 -0
  147. package/dist/readiness.js +27 -0
  148. package/dist/reads.d.ts +36 -0
  149. package/dist/reads.d.ts.map +1 -0
  150. package/dist/reads.js +136 -0
  151. package/dist/recovery.d.ts +26 -0
  152. package/dist/recovery.d.ts.map +1 -0
  153. package/dist/recovery.js +232 -0
  154. package/dist/refresh.d.ts +21 -7
  155. package/dist/refresh.d.ts.map +1 -1
  156. package/dist/refresh.js +155 -55
  157. package/dist/replica.d.ts +58 -33
  158. package/dist/replica.d.ts.map +1 -1
  159. package/dist/replica.js +355 -158
  160. package/dist/room-draft.d.ts +62 -11
  161. package/dist/room-draft.d.ts.map +1 -1
  162. package/dist/room-draft.js +281 -83
  163. package/dist/room-drafts.d.ts +29 -0
  164. package/dist/room-drafts.d.ts.map +1 -0
  165. package/dist/room-drafts.js +216 -0
  166. package/dist/rows.d.ts +32 -34
  167. package/dist/rows.d.ts.map +1 -1
  168. package/dist/rows.js +65 -87
  169. package/dist/save.d.ts +74 -6
  170. package/dist/save.d.ts.map +1 -1
  171. package/dist/save.js +902 -182
  172. package/dist/saves.d.ts +96 -0
  173. package/dist/saves.d.ts.map +1 -0
  174. package/dist/saves.js +999 -0
  175. package/dist/search.d.ts +15 -54
  176. package/dist/search.d.ts.map +1 -1
  177. package/dist/search.js +10 -121
  178. package/dist/seed.d.ts +30 -0
  179. package/dist/seed.d.ts.map +1 -0
  180. package/dist/seed.js +141 -0
  181. package/dist/shared.d.ts +15 -0
  182. package/dist/shared.d.ts.map +1 -0
  183. package/dist/shared.js +421 -0
  184. package/dist/socket/admission.d.ts +7 -0
  185. package/dist/socket/admission.d.ts.map +1 -0
  186. package/dist/socket/admission.js +39 -0
  187. package/dist/socket/answers.d.ts +6 -0
  188. package/dist/socket/answers.d.ts.map +1 -0
  189. package/dist/socket/answers.js +20 -0
  190. package/dist/socket/reads.d.ts +10 -0
  191. package/dist/socket/reads.d.ts.map +1 -0
  192. package/dist/socket/reads.js +31 -0
  193. package/dist/socket.d.ts +43 -0
  194. package/dist/socket.d.ts.map +1 -0
  195. package/dist/socket.js +96 -0
  196. package/dist/source.d.ts +61 -0
  197. package/dist/source.d.ts.map +1 -0
  198. package/dist/source.js +81 -0
  199. package/dist/status.d.ts +7 -4
  200. package/dist/status.d.ts.map +1 -1
  201. package/dist/status.js +3 -15
  202. package/dist/store/fences.d.ts +16 -0
  203. package/dist/store/fences.d.ts.map +1 -0
  204. package/dist/store/fences.js +26 -0
  205. package/dist/store/installs.d.ts +30 -0
  206. package/dist/store/installs.d.ts.map +1 -0
  207. package/dist/store/installs.js +34 -0
  208. package/dist/store/records.d.ts +212 -0
  209. package/dist/store/records.d.ts.map +1 -0
  210. package/dist/store/records.js +408 -0
  211. package/dist/store/room-held.d.ts +8 -0
  212. package/dist/store/room-held.d.ts.map +1 -0
  213. package/dist/store/room-held.js +17 -0
  214. package/dist/store/watchers.d.ts +15 -0
  215. package/dist/store/watchers.d.ts.map +1 -0
  216. package/dist/store/watchers.js +36 -0
  217. package/dist/store/writes.d.ts +24 -0
  218. package/dist/store/writes.d.ts.map +1 -0
  219. package/dist/store/writes.js +125 -0
  220. package/dist/store.d.ts +77 -94
  221. package/dist/store.d.ts.map +1 -1
  222. package/dist/store.js +118 -389
  223. package/dist/stored.d.ts +156 -0
  224. package/dist/stored.d.ts.map +1 -0
  225. package/dist/stored.js +637 -0
  226. package/dist/tables.d.ts +407 -0
  227. package/dist/tables.d.ts.map +1 -0
  228. package/dist/tables.js +724 -0
  229. package/dist/tallies.d.ts +18 -0
  230. package/dist/tallies.d.ts.map +1 -0
  231. package/dist/tallies.js +129 -0
  232. package/dist/transfer.d.ts +0 -5
  233. package/dist/transfer.d.ts.map +1 -1
  234. package/dist/turn.d.ts +9 -0
  235. package/dist/turn.d.ts.map +1 -0
  236. package/dist/turn.js +75 -0
  237. package/dist/validation.d.ts +29 -0
  238. package/dist/validation.d.ts.map +1 -0
  239. package/dist/validation.js +104 -0
  240. package/dist/windows.d.ts +11 -0
  241. package/dist/windows.d.ts.map +1 -0
  242. package/dist/windows.js +16 -0
  243. package/dist/wire.d.ts +205 -19
  244. package/dist/wire.d.ts.map +1 -1
  245. package/dist/wire.js +95 -61
  246. package/package.json +33 -10
  247. package/AGENTS.md +0 -207
  248. package/dist/attachment.d.ts +0 -3
  249. package/dist/attachment.d.ts.map +0 -1
  250. package/dist/attachment.js +0 -8
  251. package/dist/read-side.d.ts +0 -14
  252. package/dist/read-side.d.ts.map +0 -1
  253. package/dist/read-side.js +0 -371
@@ -1,18 +1,80 @@
1
+ import { cursorOf, decodedCursor } from '@agentshouse/mdmodel';
1
2
  import { conversationChangeSet } from './change-set.js';
2
- import { declaredFile } from './file.js';
3
+ import { heldFacts } from './conversation-row.js';
4
+ import { runtimeError } from './failure.js';
5
+ import { refusedForSpace } from './durability.js';
6
+ import { changeBatchIdentity, chatDraftRevision } from './identity.js';
7
+ import { OFFLINE } from './outcome.js';
8
+ import { jobsOf, runningLine } from './parts.js';
9
+ import { openQuestion } from './questions.js';
10
+ import { untilAnswered } from './recovery.js';
11
+ import { capped, FROM_START, messageOrder, precedes } from './windows.js';
3
12
  const QUIET = {
4
13
  turn: null,
5
14
  questions: [],
6
15
  process: null,
7
16
  commands: [],
8
17
  options: [],
18
+ starting: null,
19
+ subagents: [],
20
+ link: null,
21
+ deliveryUnknown: [],
9
22
  };
23
+ const FACTS = [
24
+ 'questions',
25
+ 'process',
26
+ 'commands',
27
+ 'options',
28
+ 'starting',
29
+ 'subagents',
30
+ 'link',
31
+ 'deliveryUnknown',
32
+ ];
33
+ export function unheldView(conversation) {
34
+ return {
35
+ conversation,
36
+ messages: [],
37
+ turn: null,
38
+ questions: [],
39
+ process: null,
40
+ processEnded: null,
41
+ commands: [],
42
+ options: [],
43
+ starting: null,
44
+ subagents: [],
45
+ link: null,
46
+ deliveryUnknown: [],
47
+ chatDraft: null,
48
+ jobs: [],
49
+ };
50
+ }
51
+ export const SESSION_STARTED = 'Session started';
52
+ const NEW_CHAT = 'new:';
53
+ export const HISTORY_CONVERSATIONS = 64;
54
+ // A row is read at a glance and each telling clones the list to every observing tab, while a running line changes at each Kit flush.
55
+ const ROW_INTERVAL_MS = 1_000;
56
+ export function newChat(agent) {
57
+ return `${NEW_CHAT}${agent}`;
58
+ }
59
+ function creationOf(input) {
60
+ if (typeof input !== 'object' || input === null)
61
+ return null;
62
+ const { agent_id: agent, operation_id: operation } = input;
63
+ return typeof agent === 'string' && typeof operation === 'string' ? { agent, operation } : null;
64
+ }
10
65
  function startedTurn(turn, operation) {
66
+ if (operation.op === 'begin')
67
+ return { turn, started: operation.at, parts: [], context: null };
11
68
  if (operation.op === 'context') {
12
- return { turn, parts: [], context: { used: operation.used, window: operation.window } };
69
+ return {
70
+ turn,
71
+ started: null,
72
+ parts: [],
73
+ context: { used: operation.used, window: operation.window },
74
+ };
13
75
  }
14
76
  return operation.op === 'start' && operation.index === 0
15
- ? { turn, parts: [structuredClone(operation.part)], context: null }
77
+ ? { turn, started: null, parts: [structuredClone(operation.part)], context: null }
16
78
  : null;
17
79
  }
18
80
  function changedFields(part, operation) {
@@ -27,6 +89,8 @@ function changedFields(part, operation) {
27
89
  return { entries: structuredClone(operation.entries) };
28
90
  }
29
91
  function appliedTurn(held, operation) {
92
+ if (operation.op === 'begin')
93
+ return { ...held, started: operation.at };
30
94
  if (operation.op === 'context') {
31
95
  return { ...held, context: { used: operation.used, window: operation.window } };
32
96
  }
@@ -47,18 +111,28 @@ function appliedTurn(held, operation) {
47
111
  parts: held.parts.map((kept, at) => (at === operation.index ? changed : kept)),
48
112
  };
49
113
  }
50
- function ordered(left, right) {
51
- if (left.position !== right.position)
52
- return left.position < right.position ? -1 : 1;
53
- if (left.identity !== right.identity)
54
- return left.identity < right.identity ? -1 : 1;
55
- return 0;
56
- }
57
- function merged(held, arriving) {
114
+ function windowOf(held, arriving, limit) {
58
115
  const byIdentity = new Map(held.map((message) => [message.identity, message]));
59
116
  for (const message of arriving)
60
117
  byIdentity.set(message.identity, message);
61
- return [...byIdentity.values()].sort(ordered);
118
+ const next = [...byIdentity.values()].sort(messageOrder);
119
+ const start = Math.max(0, next.length - limit);
120
+ return { messages: next.slice(start), dropped: start > 0 };
121
+ }
122
+ function frameOf(asked, messages, more, total) {
123
+ const oldest = messages[0];
124
+ const next = !more
125
+ ? undefined
126
+ : oldest === undefined
127
+ ? (asked.after ?? FROM_START)
128
+ : cursorOf([oldest.position, oldest.identity]);
129
+ return {
130
+ ...(next === undefined ? {} : { next }),
131
+ ...(total === null ? {} : { total }),
132
+ };
133
+ }
134
+ function newestOf(arriving, from) {
135
+ return arriving.reduce((top, message) => (top === null || message.position > top ? message.position : top), from);
62
136
  }
63
137
  function acceptedMessage(value) {
64
138
  if (typeof value !== 'object' || value === null)
@@ -117,84 +191,438 @@ function historyPages(result) {
117
191
  }
118
192
  return pages;
119
193
  }
120
- function turnOf(result) {
194
+ function answered(result, field) {
121
195
  if (result.kind !== 'action')
122
196
  return null;
123
197
  const answer = result.result;
124
198
  if (typeof answer !== 'object' || answer === null)
125
199
  return null;
126
- const record = answer;
127
- return typeof record.turn === 'string' ? record.turn : null;
200
+ const value = answer[field];
201
+ return typeof value === 'string' ? value : null;
202
+ }
203
+ function beforeOf(after) {
204
+ if (after === undefined)
205
+ return null;
206
+ const decoded = typeof after === 'string' ? decodedCursor(after) : null;
207
+ if (decoded?.length === 0)
208
+ return null;
209
+ const [position, identity] = decoded ?? [];
210
+ if (decoded?.length !== 2 || typeof position !== 'string' || typeof identity !== 'string') {
211
+ throw runtimeError('invalid-after', `conversation after must be the next an earlier view returned, got ${String(after)}`);
212
+ }
213
+ return [position, identity];
214
+ }
215
+ function askedOf(options) {
216
+ const { limit, after, total } = options;
217
+ if (limit !== undefined && (!Number.isInteger(limit) || limit < 0)) {
218
+ throw runtimeError('invalid-limit', `conversation limit must be a non-negative integer, got ${String(limit)}`);
219
+ }
220
+ return { limit: capped(limit), after, before: beforeOf(after), total: total === true };
221
+ }
222
+ function phraseOf(text) {
223
+ if (text === undefined)
224
+ return null;
225
+ if (typeof text !== 'string' || text === '') {
226
+ throw runtimeError('invalid-text', 'a conversation is found by a phrase');
227
+ }
228
+ return text;
229
+ }
230
+ const DURABLE_WRITE = {
231
+ kind: 'rejected',
232
+ code: 'durable-write',
233
+ fields: {},
234
+ retryable: true,
235
+ };
236
+ function unwritten(draft) {
237
+ return draft.text === '';
238
+ }
239
+ function pending(draft) {
240
+ return {
241
+ ...(draft.submitted === undefined ? {} : { submitted: draft.submitted }),
242
+ ...(draft.moves === undefined ? {} : { moves: draft.moves }),
243
+ };
128
244
  }
129
- function limitOf(options) {
130
- const { limit } = options;
131
- if (limit === undefined)
132
- return undefined;
133
- if (!Number.isInteger(limit) || limit < 0) {
134
- throw new Error(`conversation limit must be a non-negative integer, got ${String(limit)}`);
135
- }
136
- return limit;
245
+ function empty(draft) {
246
+ return unwritten(draft) && draft.submitted === undefined && draft.moves === undefined;
247
+ }
248
+ function withSubmitted(draft, submitted) {
249
+ const { submitted: _held, ...unsent } = draft;
250
+ return submitted.length === 0 ? unsent : { ...unsent, submitted };
251
+ }
252
+ function prepended(draft, said) {
253
+ return { text: [said.text, draft.text].filter((one) => one !== '').join('\n') };
254
+ }
255
+ function returned(draft, submission, others) {
256
+ return withSubmitted({
257
+ conversation: draft.conversation,
258
+ ...prepended(draft, submission),
259
+ revision: chatDraftRevision(),
260
+ }, others);
137
261
  }
138
262
  export function createConversationStore(deps) {
139
- const messages = new Map();
140
- const reads = new Map();
141
- const drafts = new Map();
142
263
  const sending = new Map();
143
264
  const behind = new Set();
265
+ const catching = new Map();
144
266
  const gaps = new Map();
145
267
  const lives = new Map();
268
+ const unsent = new Map();
146
269
  const views = new Map();
270
+ const heardNewest = new Map();
271
+ let relisting = null;
272
+ const creations = new Set();
273
+ const listWatchers = new Set();
274
+ const unlisted = new Set();
275
+ let listKnown = false;
276
+ let listOwed = false;
277
+ let listTelling = false;
278
+ let rowTimer = null;
279
+ const closing = new AbortController();
280
+ const agentWatchers = new Set();
281
+ const unnamed = new Set();
282
+ let agentsShown = null;
283
+ let listedAgents = null;
284
+ let agentsReading = false;
147
285
  let replicated = new Set();
148
286
  let handedReplicated;
149
287
  function liveOf(conversation) {
150
288
  return lives.get(conversation) ?? QUIET;
151
289
  }
152
- function shownMessages(conversation, limit) {
153
- const held = messages.get(conversation) ?? [];
154
- const shown = limit === undefined ? held : held.slice(Math.max(0, held.length - limit));
155
- return shown.map(({ identity, turn, text, message }) => ({
156
- identity,
157
- turn,
158
- text,
159
- message: structuredClone(message),
160
- }));
161
- }
162
- function viewOf(conversation, limit, shown = shownMessages(conversation, limit)) {
163
- const draft = drafts.get(conversation);
290
+ function viewOf(conversation, held, frame, draft, ended, marked) {
164
291
  const facts = liveOf(conversation);
165
292
  return {
166
293
  conversation,
167
- messages: shown,
294
+ messages: held.map(({ identity, turn, text, message }) => ({
295
+ identity,
296
+ turn,
297
+ text,
298
+ message,
299
+ })),
300
+ ...frame,
168
301
  turn: structuredClone(facts.turn),
169
302
  questions: structuredClone(facts.questions),
170
303
  process: facts.process === null ? null : { ...facts.process },
304
+ processEnded: ended,
171
305
  commands: structuredClone(facts.commands),
172
306
  options: structuredClone(facts.options),
173
- chatDraft: draft === undefined || draft.turn !== null || sending.get(conversation)?.draft === draft
174
- ? null
175
- : { text: draft.text, files: [...draft.files] },
307
+ starting: facts.starting,
308
+ subagents: structuredClone(facts.subagents),
309
+ link: facts.link === null ? null : { ...facts.link },
310
+ deliveryUnknown: [...facts.deliveryUnknown],
311
+ chatDraft: draft === null || unwritten(draft) ? null : { text: draft.text, revision: draft.revision },
312
+ jobs: facts.process?.running === false
313
+ ? []
314
+ : jobsOf(marked.filter(({ at }) => ended === null || at > ended), facts.turn),
176
315
  };
177
316
  }
178
- function emit(conversation, messagesChanged = true) {
317
+ function emit(conversation) {
179
318
  if (deps.closed())
180
319
  return;
181
320
  for (const view of views.values()) {
182
- if (view.conversation !== conversation)
321
+ if (view.conversation !== conversation || view.window === null)
183
322
  continue;
184
- if (messagesChanged)
185
- view.messages = null;
186
323
  const ready = [...view.watchers].filter((watcher) => watcher.ready);
187
324
  if (ready.length === 0)
188
325
  continue;
189
- view.messages ??= shownMessages(conversation, view.limit);
190
- const value = viewOf(conversation, view.limit, view.messages);
326
+ const value = viewOf(conversation, view.window, sharedFrame(view, view.window), view.draft, view.ended, view.marked);
191
327
  for (const watcher of ready)
192
328
  watcher.notify(value);
193
329
  }
194
330
  }
331
+ function sharedFrame(view, window) {
332
+ return frameOf(view.asked, window, view.more, view.total);
333
+ }
334
+ async function slide(local, conversation, arriving) {
335
+ let count;
336
+ let marked;
337
+ for (const view of views.values()) {
338
+ if (view.conversation !== conversation || view.window === null)
339
+ continue;
340
+ if (arriving === null) {
341
+ view.window = [];
342
+ view.marked = [];
343
+ view.more = false;
344
+ if (view.total !== null)
345
+ view.total = 0;
346
+ continue;
347
+ }
348
+ const joining = arriving.filter((message) => precedes(message, view.asked.before));
349
+ const next = windowOf(view.window, joining, view.asked.limit);
350
+ view.window = next.messages;
351
+ view.more ||= next.dropped;
352
+ if (arriving.length > 0) {
353
+ marked ??= await local.jobMarkers(conversation);
354
+ view.marked = marked;
355
+ }
356
+ if (view.total !== null && arriving.length > 0) {
357
+ count ??= await local.messageCount(conversation);
358
+ view.total = count;
359
+ }
360
+ }
361
+ }
362
+ function stateOf(conversation) {
363
+ const facts = liveOf(conversation);
364
+ if (facts.questions.length > 0)
365
+ return 'asking';
366
+ return facts.turn === null ? 'idle' : 'working';
367
+ }
368
+ function rowOf(conversation) {
369
+ const turn = lives.get(conversation)?.turn ?? null;
370
+ return {
371
+ state: stateOf(conversation),
372
+ started: turn?.started ?? null,
373
+ line: turn === null ? null : runningLine(turn.parts),
374
+ question: openQuestion(liveOf(conversation).questions),
375
+ };
376
+ }
377
+ async function entries() {
378
+ const list = await heldList();
379
+ if (list === null)
380
+ return null;
381
+ const held = list.length === 0
382
+ ? []
383
+ : await deps.durably((local) => local.conversationRows(list.map(({ conversation }) => conversation)));
384
+ const rows = new Map(held.map((one) => [one.conversation, one]));
385
+ return list.map((entry) => ({
386
+ conversation: entry.conversation,
387
+ agent: { identity: entry.agent, name: entry.agentName },
388
+ name: entry.name,
389
+ created: entry.created,
390
+ finished: entry.finished,
391
+ outcome: entry.outcome,
392
+ waiting: entry.waiting,
393
+ ...rowOf(entry.conversation),
394
+ ...heldFacts(rows.get(entry.conversation), entry),
395
+ }));
396
+ }
397
+ async function heldList() {
398
+ const stored = (await (await deps.local()).facts()).conversationList;
399
+ if (stored !== null)
400
+ return stored;
401
+ return !listKnown && deps.stream() !== undefined && deps.online() ? null : [];
402
+ }
403
+ async function endedIn(conversation) {
404
+ const list = await heldList();
405
+ return list?.find((entry) => entry.conversation === conversation)?.processEnded ?? null;
406
+ }
407
+ function listChanged(change) {
408
+ void deps
409
+ .durably(async (local) => {
410
+ const { conversationList, conversationCursor } = await local.facts();
411
+ const kept = change.replacing ? [] : (conversationList ?? []);
412
+ const held = new Map(kept.map((entry) => [entry.conversation, entry]));
413
+ for (const entry of change.set) {
414
+ held.set(entry.conversation, { ...entry });
415
+ creations.delete(entry.conversation);
416
+ }
417
+ if (change.gone !== null)
418
+ held.delete(change.gone);
419
+ const list = [...held.values()];
420
+ if (JSON.stringify(list) !== JSON.stringify(conversationList)) {
421
+ await local.fact('conversationList', list);
422
+ }
423
+ if (change.cursor !== undefined) {
424
+ if (change.cursor !== conversationCursor) {
425
+ await local.fact('conversationCursor', change.cursor);
426
+ }
427
+ deps.stream()?.hold(change.cursor);
428
+ }
429
+ return list;
430
+ })
431
+ .catch(async () => (await (await deps.local()).facts()).conversationList ?? [])
432
+ .then((list) => {
433
+ if (deps.closed() || change.paged === true)
434
+ return;
435
+ endedAnew(list);
436
+ if (change.cursor !== undefined) {
437
+ listKnown = true;
438
+ settleBehind(list);
439
+ openingEnded();
440
+ deps.settled();
441
+ }
442
+ emitList();
443
+ if (!listKnown)
444
+ return;
445
+ retiredDrafts(list);
446
+ if (change.cursor === undefined &&
447
+ (list.length !== replicated.size ||
448
+ list.some(({ conversation }) => !replicated.has(conversation)))) {
449
+ deps.again();
450
+ }
451
+ }, () => { });
452
+ }
453
+ function endedAnew(list) {
454
+ const entries = new Map(list.map((entry) => [entry.conversation, entry]));
455
+ for (const view of views.values()) {
456
+ const ended = entries.get(view.conversation)?.processEnded ?? null;
457
+ if (view.window === null || ended === view.ended)
458
+ continue;
459
+ view.ended = ended;
460
+ emit(view.conversation);
461
+ }
462
+ }
463
+ let listShown = Promise.resolve();
464
+ function shownList(work) {
465
+ const reading = heldList();
466
+ listShown = listShown.then(async () => {
467
+ const list = await reading.catch(() => null);
468
+ if (list === null || deps.closed())
469
+ return;
470
+ work(list);
471
+ });
472
+ }
473
+ async function told() {
474
+ try {
475
+ while (listOwed && !deps.closed()) {
476
+ listOwed = false;
477
+ const value = await untilAnswered(entries, closing.signal);
478
+ if (deps.closed())
479
+ return;
480
+ if (value === null)
481
+ continue;
482
+ for (const watcher of listWatchers)
483
+ watcher(value);
484
+ for (const watcher of [...unlisted]) {
485
+ unlisted.delete(watcher);
486
+ listWatchers.add(watcher);
487
+ watcher(value);
488
+ }
489
+ }
490
+ }
491
+ finally {
492
+ listTelling = false;
493
+ }
494
+ }
495
+ function tellList() {
496
+ if (deps.closed() || (listWatchers.size === 0 && unlisted.size === 0))
497
+ return;
498
+ listOwed = true;
499
+ if (listTelling)
500
+ return;
501
+ listTelling = true;
502
+ void told().catch(() => { });
503
+ }
504
+ function tellSoon() {
505
+ if (rowTimer !== null)
506
+ return;
507
+ rowTimer = setTimeout(() => {
508
+ rowTimer = null;
509
+ tellList();
510
+ }, ROW_INTERVAL_MS);
511
+ }
512
+ function emitList() {
513
+ if (deps.closed())
514
+ return;
515
+ tellList();
516
+ emitAgents();
517
+ learned();
518
+ }
519
+ function learned() {
520
+ if (deps.closed())
521
+ return;
522
+ if (unlisted.size > 0)
523
+ tellList();
524
+ if (unnamed.size === 0)
525
+ return;
526
+ shownList((list) => {
527
+ const value = agents(list);
528
+ for (const watcher of [...unnamed]) {
529
+ unnamed.delete(watcher);
530
+ agentWatchers.add(watcher);
531
+ watcher(value);
532
+ }
533
+ });
534
+ }
535
+ function agents(list) {
536
+ const named = new Map();
537
+ for (const agent of listedAgents ?? [])
538
+ named.set(agent.agent, agent);
539
+ for (const entry of list) {
540
+ named.set(entry.agent, { name: entry.agentName, retired: entry.agentRetired });
541
+ }
542
+ return [...named]
543
+ .filter(([, agent]) => !agent.retired)
544
+ .map(([identity, agent]) => ({ identity, name: agent.name }))
545
+ .sort((left, right) => left.name === right.name
546
+ ? left.identity.localeCompare(right.identity)
547
+ : left.name.localeCompare(right.name));
548
+ }
549
+ function readAgents() {
550
+ const stream = deps.stream();
551
+ if (stream?.agents === undefined || !deps.online() || agentsReading)
552
+ return;
553
+ agentsReading = true;
554
+ void stream
555
+ .agents()
556
+ .then((read) => {
557
+ if (read === null)
558
+ return;
559
+ listedAgents = read;
560
+ emitAgents();
561
+ }, () => { })
562
+ .finally(() => {
563
+ agentsReading = false;
564
+ });
565
+ }
566
+ function emitAgents() {
567
+ if (deps.closed() || agentWatchers.size === 0)
568
+ return;
569
+ shownList((list) => {
570
+ const value = agents(list);
571
+ const shown = JSON.stringify(value);
572
+ if (shown === agentsShown)
573
+ return;
574
+ agentsShown = shown;
575
+ for (const watcher of agentWatchers)
576
+ watcher(value);
577
+ });
578
+ }
579
+ function setLive(conversation, next) {
580
+ const before = rowOf(conversation);
581
+ if (next === null)
582
+ lives.delete(conversation);
583
+ else
584
+ lives.set(conversation, next);
585
+ const after = rowOf(conversation);
586
+ if (after.state !== before.state || after.started !== before.started)
587
+ emitList();
588
+ else if (after.line !== before.line || after.question !== before.question)
589
+ tellSoon();
590
+ }
591
+ function retiredChat(conversation, list) {
592
+ if (!conversation.startsWith(NEW_CHAT))
593
+ return false;
594
+ const agent = conversation.slice(NEW_CHAT.length);
595
+ return list.some((entry) => entry.agent === agent && entry.agentRetired);
596
+ }
195
597
  function live(conversation, change) {
196
- lives.set(conversation, { ...liveOf(conversation), ...change });
197
- emit(conversation, false);
598
+ const owed = unsent.get(conversation);
599
+ for (const fact of FACTS.filter((one) => one in change))
600
+ owed?.delete(fact);
601
+ setLive(conversation, { ...liveOf(conversation), ...change });
602
+ emit(conversation);
603
+ }
604
+ function openingEnded() {
605
+ const owed = [...unsent];
606
+ unsent.clear();
607
+ for (const [conversation, facts] of owed) {
608
+ const held = lives.get(conversation);
609
+ if (held === undefined || facts.size === 0)
610
+ continue;
611
+ setLive(conversation, {
612
+ turn: held.turn,
613
+ questions: facts.has('questions') ? QUIET.questions : held.questions,
614
+ process: facts.has('process') ? QUIET.process : held.process,
615
+ commands: facts.has('commands') ? QUIET.commands : held.commands,
616
+ options: facts.has('options') ? QUIET.options : held.options,
617
+ starting: facts.has('starting') ? QUIET.starting : held.starting,
618
+ subagents: facts.has('subagents') ? QUIET.subagents : held.subagents,
619
+ link: facts.has('link') ? QUIET.link : held.link,
620
+ deliveryUnknown: facts.has('deliveryUnknown')
621
+ ? QUIET.deliveryUnknown
622
+ : held.deliveryUnknown,
623
+ });
624
+ emit(conversation);
625
+ }
198
626
  }
199
627
  function relayed(conversation, turn, operation) {
200
628
  const held = liveOf(conversation).turn;
@@ -206,7 +634,7 @@ export function createConversationStore(deps) {
206
634
  const held = lives.get(conversation);
207
635
  if (held?.turn == null || !turns.has(held.turn.turn))
208
636
  return false;
209
- lives.set(conversation, { ...held, turn: null });
637
+ setLive(conversation, { ...held, turn: null });
210
638
  return true;
211
639
  }
212
640
  function handReplicated() {
@@ -220,49 +648,96 @@ export function createConversationStore(deps) {
220
648
  handedReplicated = named;
221
649
  stream.replicate(held);
222
650
  }
223
- async function documented() {
224
- const declaration = deps.cards();
225
- if (declaration === undefined)
226
- return [];
227
- const { documents } = await deps.documents(declaration.locator);
228
- return documents.filter((document) => typeof document.type === 'string');
229
- }
230
- function carded(documents) {
231
- const declaration = deps.cards();
232
- if (declaration === undefined)
233
- return [];
234
- const cards = [];
235
- for (const card of documents) {
236
- if (card.type !== declaration.type)
237
- continue;
238
- const identity = card.fields[declaration.identity];
239
- if (typeof identity === 'string')
240
- cards.push({ conversation: identity, card });
241
- }
242
- return cards;
243
- }
244
651
  async function remove(leaving) {
245
652
  await deps.durably(async (local) => {
653
+ const kept = new Set([
654
+ ...(await local.conversations(leaving)).map(({ conversation }) => conversation),
655
+ ...(await local.chatDrafts())
656
+ .filter(({ conversation }) => leaving.includes(conversation))
657
+ .map(({ conversation }) => conversation),
658
+ ]);
246
659
  await local.dropConversations(leaving);
247
- const removed = [];
248
660
  const changed = [];
249
661
  for (const conversation of leaving) {
250
- for (const message of messages.get(conversation) ?? []) {
251
- removed.push({ conversation, identity: message.identity });
252
- }
253
- if (messages.has(conversation) || drafts.has(conversation) || lives.has(conversation)) {
662
+ if (kept.has(conversation) || lives.has(conversation))
254
663
  changed.push(conversation);
664
+ for (const view of views.values()) {
665
+ if (view.conversation === conversation)
666
+ view.draft = null;
255
667
  }
256
- messages.delete(conversation);
257
- reads.delete(conversation);
258
- drafts.delete(conversation);
259
668
  behind.delete(conversation);
260
- lives.delete(conversation);
669
+ heardNewest.delete(conversation);
670
+ unsent.delete(conversation);
671
+ setLive(conversation, null);
672
+ await slide(local, conversation, null);
261
673
  }
262
674
  if (changed.length > 0)
263
- deps.publish(conversationChangeSet(removed, changed));
675
+ deps.publish(conversationChangeSet(changed));
264
676
  });
265
677
  }
678
+ function newestOfListed(entry) {
679
+ if (entry === undefined)
680
+ return undefined;
681
+ const heard = heardNewest.get(entry.conversation);
682
+ if (heard === undefined)
683
+ return entry.newest;
684
+ return entry.newest === null || heard > entry.newest ? heard : entry.newest;
685
+ }
686
+ function missed(conversation, held, entry) {
687
+ const read = held?.read;
688
+ const newest = newestOfListed(entry);
689
+ return (read === undefined ||
690
+ newest === undefined ||
691
+ held?.partial === true ||
692
+ (newest !== null && (read === null || newest > read)));
693
+ }
694
+ async function readsOf(local, conversations) {
695
+ return new Map((await local.conversations(conversations)).map((held) => [held.conversation, held]));
696
+ }
697
+ function retiredDrafts(list) {
698
+ if (!list.some((entry) => entry.agentRetired))
699
+ return;
700
+ void deps
701
+ .local()
702
+ .then((local) => local.chatDrafts())
703
+ .then((held) => {
704
+ if (!deps.closed() && held.some(({ conversation }) => retiredChat(conversation, list))) {
705
+ deps.again();
706
+ }
707
+ }, () => { });
708
+ }
709
+ function settleBehind(list) {
710
+ void deps
711
+ .durably(async (local) => {
712
+ const entries = new Map(list.map((entry) => [entry.conversation, entry]));
713
+ const named = [...replicated].filter((conversation) => entries.has(conversation));
714
+ const held = await readsOf(local, named);
715
+ let owed = false;
716
+ for (const conversation of named) {
717
+ if (!missed(conversation, held.get(conversation), entries.get(conversation))) {
718
+ behind.delete(conversation);
719
+ }
720
+ else if (!behind.has(conversation)) {
721
+ gap(conversation);
722
+ owed = true;
723
+ }
724
+ }
725
+ return owed;
726
+ })
727
+ .then((owed) => {
728
+ if (deps.closed())
729
+ return;
730
+ deps.settled();
731
+ if (owed)
732
+ deps.again();
733
+ }, () => { });
734
+ }
735
+ function noted(conversation, message) {
736
+ const heard = heardNewest.get(conversation);
737
+ if (heard === undefined || message.position > heard) {
738
+ heardNewest.set(conversation, message.position);
739
+ }
740
+ }
266
741
  function gap(conversation) {
267
742
  gaps.set(conversation, (gaps.get(conversation) ?? 0) + 1);
268
743
  behind.add(conversation);
@@ -271,37 +746,32 @@ export function createConversationStore(deps) {
271
746
  return deps.durably(async (local) => {
272
747
  if (!replicated.has(conversation))
273
748
  return;
274
- const read = reads.get(conversation);
749
+ const read = (await readsOf(local, [conversation])).get(conversation)?.read;
275
750
  const advances = read !== undefined &&
276
751
  !behind.has(conversation) &&
277
752
  (read === null || message.position > read);
278
- const sealed = drafts.get(conversation)?.turn === message.turn;
753
+ await sealed(local, conversation, new Set([message.turn]));
279
754
  await local.keepMessages({
280
755
  conversation,
281
756
  messages: [message],
282
- ...(advances ? { read: message.position } : {}),
283
- sealed,
757
+ ...(advances ? { read: { at: message.position, partial: false } } : {}),
284
758
  });
285
- messages.set(conversation, merged(messages.get(conversation) ?? [], [message]));
286
- if (advances)
287
- reads.set(conversation, message.position);
288
- if (sealed)
289
- drafts.delete(conversation);
290
759
  sealTurns(conversation, new Set([message.turn]));
291
- deps.publish(conversationChangeSet([{ conversation, identity: message.identity }], [conversation]));
760
+ await slide(local, conversation, [message]);
761
+ deps.publish(conversationChangeSet([conversation]));
762
+ tellList();
292
763
  });
293
764
  }
294
- async function readHistories(conversations) {
765
+ async function readHistories(conversations, ended) {
295
766
  const generations = new Map(conversations.map((one) => [one, gaps.get(one) ?? 0]));
296
- const starts = new Map(conversations.map((one) => [one, reads.get(one)]));
297
- const arriving = new Map();
298
- const complete = new Set();
299
- let asking = conversations.map((conversation) => ({
767
+ const held = await readsOf(await deps.local(), conversations);
768
+ let waiting = conversations.map((conversation) => ({
300
769
  conversation,
301
- after: starts.get(conversation) ?? undefined,
770
+ after: held.get(conversation)?.read ?? undefined,
302
771
  }));
303
- while (asking.length > 0) {
304
- const result = await deps.call('conversation.history', {
772
+ while (waiting.length > 0) {
773
+ const asking = waiting.slice(0, HISTORY_CONVERSATIONS);
774
+ const result = await deps.history({
305
775
  conversations: asking.map(({ conversation, after }) => ({
306
776
  conversation,
307
777
  ...(after === undefined ? {} : { after }),
@@ -310,183 +780,375 @@ export function createConversationStore(deps) {
310
780
  const pages = historyPages(result);
311
781
  if (pages === null)
312
782
  return result;
313
- const asked = new Set(asking.map(({ conversation }) => conversation));
783
+ const asked = new Map(asking.map(({ conversation, after }) => [conversation, after]));
314
784
  const following = [];
315
785
  for (const page of pages) {
316
786
  if (!asked.has(page.conversation))
317
787
  continue;
318
- arriving.set(page.conversation, [
319
- ...(arriving.get(page.conversation) ?? []),
320
- ...page.messages,
321
- ]);
322
- if (page.next === undefined)
323
- complete.add(page.conversation);
324
- else
788
+ await keepPage(page.conversation, page.messages, asked.get(page.conversation) ?? null, page.next, generations.get(page.conversation) ?? 0);
789
+ if (page.next !== undefined) {
325
790
  following.push({ conversation: page.conversation, after: page.next });
791
+ }
326
792
  }
327
- asking = following;
328
- }
329
- for (const [conversation, held] of arriving) {
330
- if (!complete.has(conversation))
331
- continue;
332
- await keepHistory(conversation, held, starts.get(conversation), generations.get(conversation) ?? 0);
793
+ for (const { conversation } of asking) {
794
+ if (!following.some((next) => next.conversation === conversation))
795
+ ended(conversation);
796
+ }
797
+ waiting = [...waiting.slice(HISTORY_CONVERSATIONS), ...following];
333
798
  }
334
799
  return null;
335
800
  }
336
- function keepHistory(conversation, arriving, from, generation) {
801
+ function caughtUp(conversations) {
802
+ const ends = new Map();
803
+ for (const conversation of conversations) {
804
+ const held = new Promise((end) => ends.set(conversation, end));
805
+ catching.set(conversation, held);
806
+ void held.then(() => {
807
+ if (catching.get(conversation) === held)
808
+ catching.delete(conversation);
809
+ });
810
+ }
811
+ const ended = (conversation) => ends.get(conversation)?.();
812
+ const read = readHistories(conversations, ended);
813
+ const endAll = () => {
814
+ for (const conversation of conversations)
815
+ ended(conversation);
816
+ };
817
+ read.then(endAll, endAll);
818
+ return read;
819
+ }
820
+ function keepPage(conversation, arriving, from, next, generation) {
337
821
  return deps.durably(async (local) => {
338
822
  if (!replicated.has(conversation))
339
823
  return;
340
- const newest = arriving.reduce((top, message) => (top === null || message.position > top ? message.position : top), from ?? null);
341
- const turn = drafts.get(conversation)?.turn;
342
- const sealed = arriving.some((message) => message.turn === turn);
343
- await local.keepMessages({ conversation, messages: arriving, read: newest, sealed });
344
- messages.set(conversation, merged(messages.get(conversation) ?? [], arriving));
345
- reads.set(conversation, newest);
346
- if (sealed)
347
- drafts.delete(conversation);
824
+ const whole = next === undefined;
825
+ const cursor = next ?? newestOf(arriving, from);
826
+ const held = (await readsOf(local, [conversation])).get(conversation);
827
+ const partial = !whole && (held?.partial === true || held?.read === undefined);
828
+ const sealing = await sealed(local, conversation, new Set(arriving.map((message) => message.turn)));
829
+ await local.keepMessages({ conversation, messages: arriving, read: { at: cursor, partial } });
348
830
  sealTurns(conversation, new Set(arriving.map((message) => message.turn)));
349
- if ((gaps.get(conversation) ?? 0) === generation)
831
+ if (whole && (gaps.get(conversation) ?? 0) === generation)
350
832
  behind.delete(conversation);
351
- if (arriving.length > 0 || sealed) {
352
- deps.publish(conversationChangeSet(arriving.map((message) => ({ conversation, identity: message.identity })), [conversation]));
833
+ await slide(local, conversation, arriving);
834
+ if (arriving.length > 0 || sealing || whole) {
835
+ deps.publish(conversationChangeSet([conversation]));
353
836
  }
837
+ if (arriving.length > 0)
838
+ tellSoon();
839
+ });
840
+ }
841
+ function heard(event) {
842
+ const { conversation } = event;
843
+ if (event.kind === 'gap') {
844
+ if (replicated.has(conversation))
845
+ gap(conversation);
846
+ if (lives.has(conversation))
847
+ unsent.set(conversation, new Set(FACTS));
848
+ return;
849
+ }
850
+ if (event.kind === 'turn') {
851
+ relayed(conversation, event.turn, event.operation);
852
+ return;
853
+ }
854
+ if (event.kind === 'questions') {
855
+ live(conversation, { questions: structuredClone(event.questions) });
856
+ return;
857
+ }
858
+ if (event.kind === 'process') {
859
+ live(conversation, { process: { running: event.running } });
860
+ return;
861
+ }
862
+ if (event.kind === 'commands') {
863
+ live(conversation, { commands: structuredClone(event.commands) });
864
+ return;
865
+ }
866
+ if (event.kind === 'options') {
867
+ live(conversation, { options: structuredClone(event.options) });
868
+ return;
869
+ }
870
+ if (event.kind === 'starting') {
871
+ live(conversation, { starting: event.step });
872
+ return;
873
+ }
874
+ if (event.kind === 'subagents') {
875
+ live(conversation, { subagents: structuredClone(event.subagents) });
876
+ return;
877
+ }
878
+ if (event.kind === 'link') {
879
+ live(conversation, { link: { connected: event.connected } });
880
+ return;
881
+ }
882
+ if (event.kind === 'deliveries') {
883
+ live(conversation, { deliveryUnknown: [...event.unknown] });
884
+ return;
885
+ }
886
+ const arriving = acceptedMessage(event.message);
887
+ if (arriving === null)
888
+ return;
889
+ noted(conversation, arriving);
890
+ if (replicated.has(conversation)) {
891
+ if (deps.full()) {
892
+ gap(conversation);
893
+ return;
894
+ }
895
+ void keep(conversation, arriving).catch((error) => {
896
+ if (refusedForSpace(error))
897
+ gap(conversation);
898
+ });
899
+ return;
900
+ }
901
+ if (sealTurns(conversation, new Set([arriving.turn])))
902
+ emit(conversation);
903
+ }
904
+ async function kept(local, conversation, following) {
905
+ const shown = following === null || empty(following) ? null : following;
906
+ if (shown === null)
907
+ await local.dropChatDraft(conversation);
908
+ else
909
+ await local.keepChatDrafts([shown]);
910
+ shownDraft(conversation, shown);
911
+ }
912
+ function shownDraft(conversation, draft) {
913
+ for (const view of views.values()) {
914
+ if (view.conversation === conversation)
915
+ view.draft = draft;
916
+ }
917
+ }
918
+ async function draftAt(local, conversation) {
919
+ return (await local.chatDraft(conversation)) ?? undefined;
920
+ }
921
+ async function sealed(local, conversation, turns) {
922
+ const held = await draftAt(local, conversation);
923
+ const submitted = held?.submitted ?? [];
924
+ const left = submitted.filter((one) => one.turn === null || !turns.has(one.turn));
925
+ if (held === undefined || left.length === submitted.length)
926
+ return false;
927
+ await kept(local, conversation, withSubmitted(held, left));
928
+ return true;
929
+ }
930
+ function moved(agent, operation, to) {
931
+ const from = newChat(agent);
932
+ return deps.durably(async (local) => {
933
+ const held = await draftAt(local, from);
934
+ const earlier = held?.moves ?? [];
935
+ if (earlier.includes(operation))
936
+ return;
937
+ const blank = {
938
+ conversation: from,
939
+ text: '',
940
+ revision: chatDraftRevision(),
941
+ };
942
+ const { moves: _answered, ...unsent } = held ?? blank;
943
+ const taken = (await draftAt(local, to)) !== undefined || empty(unsent)
944
+ ? []
945
+ : [{ ...unsent, conversation: to }];
946
+ const left = { ...(taken.length === 0 ? unsent : blank), moves: [...earlier, operation] };
947
+ await local.keepChatDrafts([left, ...taken]);
948
+ shownDraft(from, left);
949
+ for (const one of taken)
950
+ shownDraft(to, one);
951
+ deps.publish(conversationChangeSet([from, to]));
354
952
  });
355
953
  }
356
954
  function withDraft(conversation, next) {
357
955
  return deps.durably(async (local) => {
358
- const following = next(drafts.get(conversation));
956
+ const following = await next(await draftAt(local, conversation), local);
359
957
  if (following === undefined)
360
958
  return;
361
- if (following === null) {
362
- await local.dropChatDraft(conversation);
363
- drafts.delete(conversation);
364
- }
365
- else {
366
- await local.keepChatDraft(following);
367
- drafts.set(conversation, following);
368
- }
369
- deps.publish(conversationChangeSet([], [conversation]));
959
+ await kept(local, conversation, following);
960
+ deps.publish(conversationChangeSet([conversation]));
370
961
  });
371
962
  }
372
- function invoke(name, conversation, extra = {}) {
373
- return deps.call(name, { conversation, ...extra });
963
+ async function submitted(conversation, operation, draft) {
964
+ let submission;
965
+ await withDraft(conversation, (current) => {
966
+ submission = current?.submitted?.find((one) => one.operation === operation);
967
+ if (submission !== undefined)
968
+ return undefined;
969
+ const said = draft ?? current;
970
+ submission = { operation, text: said?.text ?? '', turn: null };
971
+ return {
972
+ conversation,
973
+ ...(draft === undefined || current === undefined
974
+ ? { text: '', revision: chatDraftRevision() }
975
+ : { text: current.text, revision: current.revision }),
976
+ submitted: [...(current?.submitted ?? []), submission],
977
+ };
978
+ });
979
+ return submission;
980
+ }
981
+ async function dispatched(conversation, submission) {
982
+ const dispatch = { answered: false };
983
+ sending.set(submission.operation, dispatch);
984
+ try {
985
+ const result = await invoke('conversations/send', conversation, {
986
+ operation_id: submission.operation,
987
+ text: submission.text,
988
+ });
989
+ dispatch.answered = result.kind !== 'transport-uncertainty';
990
+ if (result.kind === 'revoked-authorization')
991
+ return result;
992
+ if (result.kind !== 'action' && result.retryable) {
993
+ deps.unanswered();
994
+ return result;
995
+ }
996
+ const turn = answered(result, 'message_id');
997
+ await withDraft(conversation, async (current, local) => {
998
+ const held = current?.submitted?.find((one) => one.operation === submission.operation);
999
+ if (current === undefined || held === undefined || held.turn !== null)
1000
+ return undefined;
1001
+ const others = current.submitted.filter((one) => one !== held);
1002
+ if (result.kind !== 'action')
1003
+ return returned(current, held, others);
1004
+ const arrived = turn !== null && (await local.turnArrived(conversation, turn));
1005
+ return withSubmitted(current, turn === null || arrived
1006
+ ? others
1007
+ : current.submitted.map((one) => (one === held ? { ...held, turn } : one)));
1008
+ });
1009
+ return result;
1010
+ }
1011
+ finally {
1012
+ if (sending.get(submission.operation) === dispatch)
1013
+ sending.delete(submission.operation);
1014
+ }
1015
+ }
1016
+ function invoke(name, conversation, extra = { operation_id: changeBatchIdentity() }) {
1017
+ return deps.call(name, { conversation_id: conversation, ...extra });
374
1018
  }
375
1019
  const surface = {
376
- async list() {
377
- const declaration = deps.cards();
378
- if (declaration === undefined)
379
- return [];
380
- const documents = await documented();
381
- const entries = carded(documents).map(({ conversation, card }) => ({
382
- conversation,
383
- card,
384
- agent: documents.find((document) => document.backlinks.some((backlink) => backlink.path === card.path && backlink.field === declaration.agent)) ?? null,
385
- }));
386
- entries.sort((left, right) => (left.conversation < right.conversation ? -1 : 1));
387
- return entries;
1020
+ list() {
1021
+ return new Promise((settle) => {
1022
+ const answer = (listed) => {
1023
+ unlisted.delete(answer);
1024
+ listWatchers.delete(answer);
1025
+ settle(listed);
1026
+ };
1027
+ unlisted.add(answer);
1028
+ learned();
1029
+ });
388
1030
  },
389
1031
  async read(conversation, options = {}) {
390
- const limit = limitOf(options);
391
- return deps.durably(() => Promise.resolve(viewOf(conversation, limit)));
392
- },
393
- create(input) {
394
- return deps.call('conversation.create', input);
1032
+ const { text, ...windowed } = options;
1033
+ const asked = askedOf(windowed);
1034
+ const phrase = phraseOf(text);
1035
+ return deps.durably(async (local) => {
1036
+ const { messages, more } = await local.messageWindow(conversation, asked.limit, asked.before, phrase);
1037
+ const total = asked.total ? await local.messageCount(conversation, phrase) : null;
1038
+ const marked = await local.jobMarkers(conversation);
1039
+ return structuredClone(viewOf(conversation, messages, frameOf(asked, messages, more, total), (await local.chatDraft(conversation)) ?? null, await endedIn(conversation), marked));
1040
+ });
395
1041
  },
396
- async send(conversation) {
397
- const draft = drafts.get(conversation);
398
- const pending = draft === undefined ? undefined : { draft };
399
- if (pending !== undefined) {
400
- sending.set(conversation, pending);
401
- deps.publish(conversationChangeSet([], [conversation]));
1042
+ async create(input) {
1043
+ const result = await deps.call('conversations/create', input);
1044
+ const conversation = answered(result, 'conversation_id');
1045
+ if (conversation === null)
1046
+ return result;
1047
+ const listed = (await heldList()) ?? [];
1048
+ if (!listed.some((entry) => entry.conversation === conversation)) {
1049
+ creations.add(conversation);
402
1050
  }
403
- try {
404
- const files = await Promise.all((draft?.files ?? []).map(async (file) => ({
405
- ...(await declaredFile(file)),
406
- blob: file.blob,
407
- })));
408
- const result = await invoke('conversation.send', conversation, {
409
- text: draft?.text ?? '',
410
- files,
411
- });
412
- const turn = turnOf(result);
413
- if (turn === null || draft === undefined)
414
- return result;
415
- await withDraft(conversation, (current) => {
416
- if (current !== draft)
417
- return undefined;
418
- const sealed = (messages.get(conversation) ?? []).some((message) => message.turn === turn);
419
- return sealed ? null : { ...draft, turn };
1051
+ const creation = creationOf(input);
1052
+ if (creation !== null)
1053
+ await moved(creation.agent, creation.operation, conversation);
1054
+ return result;
1055
+ },
1056
+ async send(conversation, operation = changeBatchIdentity(), draft) {
1057
+ if (deps.full())
1058
+ return DURABLE_WRITE;
1059
+ if (deps.online()) {
1060
+ const held = await submitted(conversation, operation, draft).catch((error) => {
1061
+ if (refusedForSpace(error))
1062
+ return null;
1063
+ throw error;
420
1064
  });
421
- return result;
1065
+ if (held === null)
1066
+ return DURABLE_WRITE;
1067
+ return dispatched(conversation, held);
422
1068
  }
423
- finally {
424
- if (pending !== undefined && sending.get(conversation) === pending) {
425
- sending.delete(conversation);
426
- if (drafts.get(conversation) === draft) {
427
- deps.publish(conversationChangeSet([], [conversation]));
428
- }
429
- }
1069
+ if (draft !== undefined) {
1070
+ await withDraft(conversation, (current) => current?.submitted?.some((one) => one.operation === operation) === true
1071
+ ? undefined
1072
+ : returned(current ?? { conversation, text: '', revision: '' }, { operation, ...draft, turn: null }, current?.submitted ?? []));
430
1073
  }
1074
+ return OFFLINE;
431
1075
  },
432
1076
  answer(conversation, answer) {
433
- return invoke('conversation.answer', conversation, { answer });
1077
+ return invoke('conversations/interaction/answer', conversation, {
1078
+ operation_id: changeBatchIdentity(),
1079
+ ...answer,
1080
+ });
434
1081
  },
435
1082
  interrupt(conversation) {
436
- return invoke('conversation.interrupt', conversation);
1083
+ return invoke('conversations/interrupt', conversation);
437
1084
  },
438
1085
  kill(conversation) {
439
- return invoke('conversation.kill', conversation);
440
- },
441
- async cancel(conversation, turn) {
442
- const result = await invoke('conversation.cancel', conversation, { turn });
443
- if (result.kind !== 'action')
444
- return result;
445
- await withDraft(conversation, (current) => current === undefined || current.turn !== turn ? undefined : { ...current, turn: null });
446
- return result;
1086
+ return invoke('conversations/kill', conversation);
447
1087
  },
448
1088
  delete(conversation) {
449
- return invoke('conversation.delete', conversation);
1089
+ return invoke('conversations/delete', conversation);
450
1090
  },
451
1091
  };
452
1092
  const chatDraft = {
453
- write(conversation, draft) {
454
- return withDraft(conversation, () => ({
1093
+ write(conversation, draft, revision = chatDraftRevision()) {
1094
+ return withDraft(conversation, (current) => ({
455
1095
  conversation,
456
1096
  text: draft.text,
457
- files: [...draft.files],
458
- turn: null,
1097
+ revision,
1098
+ ...(current === undefined ? {} : pending(current)),
1099
+ }));
1100
+ },
1101
+ prepend(conversation, draft) {
1102
+ return withDraft(conversation, (current) => ({
1103
+ conversation,
1104
+ ...(current === undefined ? { text: draft.text } : prepended(current, draft)),
1105
+ revision: chatDraftRevision(),
1106
+ ...(current === undefined ? {} : pending(current)),
459
1107
  }));
460
1108
  },
461
1109
  discard(conversation) {
462
- return withDraft(conversation, (current) => (current === undefined ? undefined : null));
1110
+ return withDraft(conversation, (current) => current === undefined
1111
+ ? undefined
1112
+ : { conversation, text: '', revision: chatDraftRevision(), ...pending(current) });
463
1113
  },
464
1114
  };
465
1115
  return {
466
1116
  surface,
467
1117
  chatDraft,
468
- hydrate(held, stored) {
469
- messages.clear();
470
- reads.clear();
471
- for (const view of views.values())
472
- view.messages = null;
473
- for (const entry of held) {
474
- messages.set(entry.conversation, [...entry.messages].sort(ordered));
475
- if (entry.read !== undefined)
476
- reads.set(entry.conversation, entry.read);
477
- }
478
- drafts.clear();
479
- for (const record of stored)
480
- drafts.set(record.conversation, record);
1118
+ async opened(local) {
1119
+ const { conversationList, conversationCursor } = await local.facts();
1120
+ if (conversationList === null || listKnown)
1121
+ return;
1122
+ deps.stream()?.hold(conversationCursor);
1123
+ learned();
481
1124
  },
482
1125
  async reconcile() {
483
- const named = new Set(carded(await documented()).map((entry) => entry.conversation));
1126
+ if (!listKnown)
1127
+ return;
1128
+ const local = await deps.local();
1129
+ const [held, kept, { conversationList }] = await Promise.all([
1130
+ local.conversations(),
1131
+ local.chatDrafts(),
1132
+ local.facts(),
1133
+ ]);
1134
+ const list = conversationList ?? [];
1135
+ const entries = new Map(list.map((entry) => [entry.conversation, entry]));
1136
+ const named = new Set(entries.keys());
1137
+ const reads = new Map(held.map((one) => [one.conversation, one]));
484
1138
  const leaving = [
485
- ...new Set([...replicated, ...messages.keys(), ...reads.keys(), ...drafts.keys()]),
486
- ].filter((conversation) => !named.has(conversation));
1139
+ ...new Set([
1140
+ ...replicated,
1141
+ ...reads.keys(),
1142
+ ...kept.map(({ conversation }) => conversation),
1143
+ ]),
1144
+ ].filter((conversation) => !named.has(conversation) &&
1145
+ !creations.has(conversation) &&
1146
+ (!conversation.startsWith(NEW_CHAT) || retiredChat(conversation, list)));
487
1147
  for (const conversation of named) {
488
- if (!replicated.has(conversation))
1148
+ if (!replicated.has(conversation) &&
1149
+ missed(conversation, reads.get(conversation), entries.get(conversation))) {
489
1150
  behind.add(conversation);
1151
+ }
490
1152
  }
491
1153
  replicated = named;
492
1154
  handReplicated();
@@ -494,50 +1156,131 @@ export function createConversationStore(deps) {
494
1156
  await remove(leaving);
495
1157
  },
496
1158
  async catchUp(progress) {
497
- const reading = [...behind].filter((conversation) => replicated.has(conversation)).sort();
498
- if (reading.length > 0 && !deps.closed()) {
499
- const failed = await readHistories(reading);
1159
+ if (deps.full()) {
1160
+ if (behind.size > 0)
1161
+ progress.complete = false;
1162
+ return;
1163
+ }
1164
+ const owed = (conversation) => behind.has(conversation) && replicated.has(conversation);
1165
+ const read = async (conversations) => {
1166
+ if (conversations.length === 0 || deps.closed())
1167
+ return;
1168
+ const failed = await caughtUp(conversations);
500
1169
  if (failed?.kind === 'transport-uncertainty')
501
1170
  progress.reachable = false;
502
- }
1171
+ };
1172
+ const asking = [...behind].filter(owed).sort();
1173
+ const awaited = asking.filter((conversation) => catching.has(conversation));
1174
+ await Promise.all([
1175
+ read(asking.filter((conversation) => !catching.has(conversation))),
1176
+ Promise.all(awaited.map((conversation) => catching.get(conversation))).then(() => read(awaited.filter((conversation) => owed(conversation) && !catching.has(conversation)))),
1177
+ ]);
503
1178
  if (behind.size > 0)
504
1179
  progress.complete = false;
505
1180
  },
1181
+ async resend(progress) {
1182
+ const local = await deps.local();
1183
+ const tried = new Set();
1184
+ for (const { conversation } of await local.chatDrafts()) {
1185
+ for (;;) {
1186
+ const submission = (await local.chatDraft(conversation))?.submitted?.find((one) => one.turn === null && !sending.has(one.operation) && !tried.has(one.operation));
1187
+ if (submission === undefined)
1188
+ break;
1189
+ if (deps.closed())
1190
+ return;
1191
+ tried.add(submission.operation);
1192
+ const result = await dispatched(conversation, submission);
1193
+ if (result.kind === 'revoked-authorization')
1194
+ return;
1195
+ if (result.kind === 'transport-uncertainty') {
1196
+ progress.reachable = false;
1197
+ return;
1198
+ }
1199
+ if (result.kind !== 'action' && result.retryable) {
1200
+ progress.complete = false;
1201
+ return;
1202
+ }
1203
+ }
1204
+ }
1205
+ },
506
1206
  current() {
507
1207
  return behind.size === 0;
508
1208
  },
509
- reconnected() {
510
- for (const conversation of replicated)
511
- gap(conversation);
1209
+ known() {
1210
+ return listKnown;
1211
+ },
1212
+ reopened() {
1213
+ relisting = null;
1214
+ for (const [operation, dispatch] of sending)
1215
+ if (!dispatch.answered)
1216
+ sending.delete(operation);
1217
+ },
1218
+ lost() {
1219
+ catching.clear();
512
1220
  },
513
1221
  watch(conversation, options, deliver) {
514
- const limit = limitOf(options);
515
- const key = JSON.stringify([conversation, limit ?? null]);
1222
+ const asked = askedOf(options);
1223
+ const key = JSON.stringify([conversation, asked.limit, asked.after ?? null, asked.total]);
516
1224
  const view = views.get(key) ?? {
517
1225
  conversation,
518
- limit,
1226
+ asked,
519
1227
  watchers: new Set(),
520
- messages: null,
1228
+ window: null,
1229
+ draft: null,
1230
+ ended: null,
1231
+ marked: [],
1232
+ more: false,
1233
+ total: null,
521
1234
  };
522
1235
  views.set(key, view);
523
1236
  const watcher = { notify: deliver, ready: false };
524
1237
  view.watchers.add(watcher);
525
- void deps
526
- .durably(() => Promise.resolve())
1238
+ const reading = new AbortController();
1239
+ void untilAnswered(() => deps.durably(async (local) => {
1240
+ if (view.window !== null)
1241
+ return;
1242
+ const { messages, more } = await local.messageWindow(conversation, asked.limit, asked.before);
1243
+ view.draft = (await local.chatDraft(conversation)) ?? null;
1244
+ view.ended = await endedIn(conversation);
1245
+ view.window = messages;
1246
+ view.marked = await local.jobMarkers(conversation);
1247
+ view.more = more;
1248
+ view.total = asked.total ? await local.messageCount(conversation) : null;
1249
+ }), reading.signal)
527
1250
  .then(() => {
528
1251
  if (deps.closed() || !view.watchers.has(watcher))
529
1252
  return;
530
1253
  watcher.ready = true;
531
- watcher.notify(viewOf(conversation, limit));
1254
+ const window = view.window ?? [];
1255
+ watcher.notify(viewOf(conversation, window, sharedFrame(view, window), view.draft, view.ended, view.marked));
532
1256
  })
533
1257
  .catch(() => { });
534
1258
  return () => {
1259
+ reading.abort();
535
1260
  if (!view.watchers.delete(watcher))
536
1261
  return;
537
1262
  if (view.watchers.size === 0)
538
1263
  views.delete(key);
539
1264
  };
540
1265
  },
1266
+ watchList(deliver) {
1267
+ unlisted.add(deliver);
1268
+ learned();
1269
+ return () => {
1270
+ unlisted.delete(deliver);
1271
+ listWatchers.delete(deliver);
1272
+ };
1273
+ },
1274
+ watchAgents(deliver) {
1275
+ unnamed.add(deliver);
1276
+ learned();
1277
+ readAgents();
1278
+ return () => {
1279
+ unnamed.delete(deliver);
1280
+ agentWatchers.delete(deliver);
1281
+ };
1282
+ },
1283
+ learned,
541
1284
  changed(set) {
542
1285
  for (const conversation of set.conversations)
543
1286
  emit(conversation);
@@ -545,57 +1288,49 @@ export function createConversationStore(deps) {
545
1288
  receive(event) {
546
1289
  if (deps.closed())
547
1290
  return;
548
- const { conversation } = event;
549
- if (event.kind === 'gap') {
550
- if (replicated.has(conversation))
551
- gap(conversation);
552
- const held = lives.get(conversation);
553
- if (held === undefined)
1291
+ if (event.kind === 'list') {
1292
+ if (event.whole)
1293
+ relisting ??= new Map();
1294
+ if (relisting !== null) {
1295
+ for (const entry of event.entries)
1296
+ relisting.set(entry.conversation, { ...entry });
1297
+ }
1298
+ if (event.more && relisting !== null)
554
1299
  return;
555
- lives.set(conversation, { ...QUIET, turn: held.turn });
556
- emit(conversation, false);
557
- return;
558
- }
559
- if (event.kind === 'turn') {
560
- relayed(conversation, event.turn, event.operation);
561
- return;
562
- }
563
- if (event.kind === 'questions') {
564
- live(conversation, { questions: structuredClone(event.questions) });
565
- return;
566
- }
567
- if (event.kind === 'process') {
568
- live(conversation, { process: { running: event.running } });
569
- return;
570
- }
571
- if (event.kind === 'commands') {
572
- live(conversation, { commands: structuredClone(event.commands) });
1300
+ const whole = relisting;
1301
+ relisting = null;
1302
+ listChanged({
1303
+ replacing: whole !== null,
1304
+ set: whole === null ? event.entries : [...whole.values()],
1305
+ gone: null,
1306
+ ...(event.more ? { paged: true } : { cursor: event.cursor }),
1307
+ });
573
1308
  return;
574
1309
  }
575
- if (event.kind === 'options') {
576
- live(conversation, { options: structuredClone(event.options) });
1310
+ if (event.kind === 'listed') {
1311
+ relisting?.set(event.entry.conversation, { ...event.entry });
1312
+ listChanged({ replacing: false, set: [event.entry], gone: null });
577
1313
  return;
578
1314
  }
579
- const arriving = acceptedMessage(event.message);
580
- if (arriving === null)
581
- return;
582
- if (replicated.has(conversation)) {
583
- void keep(conversation, arriving).catch(() => { });
1315
+ if (event.kind === 'unlisted') {
1316
+ relisting?.delete(event.conversation);
1317
+ listChanged({ replacing: false, set: [], gone: event.conversation });
584
1318
  return;
585
1319
  }
586
- if (sealTurns(conversation, new Set([arriving.turn])))
587
- emit(conversation);
588
- },
589
- messages() {
590
- return [...messages].flatMap(([conversation, held]) => held.map(({ identity, text }) => ({ conversation, identity, text })));
591
- },
592
- message(conversation, identity) {
593
- const held = messages.get(conversation)?.find((message) => message.identity === identity);
594
- return held === undefined ? null : { conversation, identity, text: held.text };
1320
+ heard(event);
595
1321
  },
596
1322
  close() {
1323
+ closing.abort();
1324
+ if (rowTimer !== null)
1325
+ clearTimeout(rowTimer);
1326
+ rowTimer = null;
597
1327
  views.clear();
598
1328
  lives.clear();
1329
+ unsent.clear();
1330
+ listWatchers.clear();
1331
+ unlisted.clear();
1332
+ agentWatchers.clear();
1333
+ unnamed.clear();
599
1334
  },
600
1335
  };
601
1336
  }