@agentshouse/mdruntime 0.1.0-ca7c26c6bc27e → 0.1.0-ca8707258fdde

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 +200 -54
  6. package/dist/adapter.d.ts.map +1 -1
  7. package/dist/adapter.js +1 -9
  8. package/dist/attached-model.d.ts +7 -10
  9. package/dist/attached-model.d.ts.map +1 -1
  10. package/dist/attached-model.js +40 -28
  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 +37 -5
  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 +61 -43
  42. package/dist/connection.d.ts.map +1 -1
  43. package/dist/connection.js +2377 -1476
  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 +71 -22
  51. package/dist/conversation.d.ts.map +1 -1
  52. package/dist/conversation.js +996 -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 +11 -2
  75. package/dist/host.d.ts.map +1 -1
  76. package/dist/host.js +134 -34
  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 +22 -8
  98. package/dist/memory.d.ts.map +1 -1
  99. package/dist/memory.js +299 -94
  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 -12
  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 -4
  110. package/dist/observation.d.ts.map +1 -1
  111. package/dist/observation.js +120 -14
  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 +52 -181
  131. package/dist/query.d.ts.map +1 -1
  132. package/dist/query.js +3 -423
  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 +19 -5
  137. package/dist/reach.d.ts.map +1 -1
  138. package/dist/reach.js +309 -92
  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 +35 -0
  149. package/dist/reads.d.ts.map +1 -0
  150. package/dist/reads.js +128 -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 +20 -7
  155. package/dist/refresh.d.ts.map +1 -1
  156. package/dist/refresh.js +155 -59
  157. package/dist/replica.d.ts +58 -34
  158. package/dist/replica.d.ts.map +1 -1
  159. package/dist/replica.js +355 -162
  160. package/dist/room-draft.d.ts +59 -11
  161. package/dist/room-draft.d.ts.map +1 -1
  162. package/dist/room-draft.js +276 -80
  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 -93
  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 +185 -45
  244. package/dist/wire.d.ts.map +1 -1
  245. package/dist/wire.js +75 -46
  246. package/package.json +33 -10
  247. package/AGENTS.md +0 -215
  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 -18
  252. package/dist/read-side.d.ts.map +0 -1
  253. package/dist/read-side.js +0 -377
@@ -1,12 +1,35 @@
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
+ ];
10
33
  export function unheldView(conversation) {
11
34
  return {
12
35
  conversation,
@@ -14,17 +37,44 @@ export function unheldView(conversation) {
14
37
  turn: null,
15
38
  questions: [],
16
39
  process: null,
40
+ processEnded: null,
17
41
  commands: [],
18
42
  options: [],
43
+ starting: null,
44
+ subagents: [],
45
+ link: null,
46
+ deliveryUnknown: [],
19
47
  chatDraft: null,
48
+ jobs: [],
20
49
  };
21
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
+ }
22
65
  function startedTurn(turn, operation) {
66
+ if (operation.op === 'begin')
67
+ return { turn, started: operation.at, parts: [], context: null };
23
68
  if (operation.op === 'context') {
24
- 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
+ };
25
75
  }
26
76
  return operation.op === 'start' && operation.index === 0
27
- ? { turn, parts: [structuredClone(operation.part)], context: null }
77
+ ? { turn, started: null, parts: [structuredClone(operation.part)], context: null }
28
78
  : null;
29
79
  }
30
80
  function changedFields(part, operation) {
@@ -39,6 +89,8 @@ function changedFields(part, operation) {
39
89
  return { entries: structuredClone(operation.entries) };
40
90
  }
41
91
  function appliedTurn(held, operation) {
92
+ if (operation.op === 'begin')
93
+ return { ...held, started: operation.at };
42
94
  if (operation.op === 'context') {
43
95
  return { ...held, context: { used: operation.used, window: operation.window } };
44
96
  }
@@ -59,18 +111,28 @@ function appliedTurn(held, operation) {
59
111
  parts: held.parts.map((kept, at) => (at === operation.index ? changed : kept)),
60
112
  };
61
113
  }
62
- function ordered(left, right) {
63
- if (left.position !== right.position)
64
- return left.position < right.position ? -1 : 1;
65
- if (left.identity !== right.identity)
66
- return left.identity < right.identity ? -1 : 1;
67
- return 0;
68
- }
69
- function merged(held, arriving) {
114
+ function windowOf(held, arriving, limit) {
70
115
  const byIdentity = new Map(held.map((message) => [message.identity, message]));
71
116
  for (const message of arriving)
72
117
  byIdentity.set(message.identity, message);
73
- 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);
74
136
  }
75
137
  function acceptedMessage(value) {
76
138
  if (typeof value !== 'object' || value === null)
@@ -129,84 +191,438 @@ function historyPages(result) {
129
191
  }
130
192
  return pages;
131
193
  }
132
- function turnOf(result) {
194
+ function answered(result, field) {
133
195
  if (result.kind !== 'action')
134
196
  return null;
135
197
  const answer = result.result;
136
198
  if (typeof answer !== 'object' || answer === null)
137
199
  return null;
138
- const record = answer;
139
- 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
+ };
244
+ }
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') };
140
254
  }
141
- function limitOf(options) {
142
- const { limit } = options;
143
- if (limit === undefined)
144
- return undefined;
145
- if (!Number.isInteger(limit) || limit < 0) {
146
- throw new Error(`conversation limit must be a non-negative integer, got ${String(limit)}`);
147
- }
148
- return limit;
255
+ function returned(draft, submission, others) {
256
+ return withSubmitted({
257
+ conversation: draft.conversation,
258
+ ...prepended(draft, submission),
259
+ revision: chatDraftRevision(),
260
+ }, others);
149
261
  }
150
262
  export function createConversationStore(deps) {
151
- const messages = new Map();
152
- const reads = new Map();
153
- const drafts = new Map();
154
263
  const sending = new Map();
155
264
  const behind = new Set();
265
+ const catching = new Map();
156
266
  const gaps = new Map();
157
267
  const lives = new Map();
268
+ const unsent = new Map();
158
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;
159
285
  let replicated = new Set();
160
286
  let handedReplicated;
161
287
  function liveOf(conversation) {
162
288
  return lives.get(conversation) ?? QUIET;
163
289
  }
164
- function shownMessages(conversation, limit) {
165
- const held = messages.get(conversation) ?? [];
166
- const shown = limit === undefined ? held : held.slice(Math.max(0, held.length - limit));
167
- return shown.map(({ identity, turn, text, message }) => ({
168
- identity,
169
- turn,
170
- text,
171
- message: structuredClone(message),
172
- }));
173
- }
174
- function viewOf(conversation, limit, shown = shownMessages(conversation, limit)) {
175
- const draft = drafts.get(conversation);
290
+ function viewOf(conversation, held, frame, draft, ended, marked) {
176
291
  const facts = liveOf(conversation);
177
292
  return {
178
293
  conversation,
179
- messages: shown,
294
+ messages: held.map(({ identity, turn, text, message }) => ({
295
+ identity,
296
+ turn,
297
+ text,
298
+ message,
299
+ })),
300
+ ...frame,
180
301
  turn: structuredClone(facts.turn),
181
302
  questions: structuredClone(facts.questions),
182
303
  process: facts.process === null ? null : { ...facts.process },
304
+ processEnded: ended,
183
305
  commands: structuredClone(facts.commands),
184
306
  options: structuredClone(facts.options),
185
- chatDraft: draft === undefined || draft.turn !== null || sending.get(conversation)?.draft === draft
186
- ? null
187
- : { 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),
188
315
  };
189
316
  }
190
- function emit(conversation, messagesChanged = true) {
317
+ function emit(conversation) {
191
318
  if (deps.closed())
192
319
  return;
193
320
  for (const view of views.values()) {
194
- if (view.conversation !== conversation)
321
+ if (view.conversation !== conversation || view.window === null)
195
322
  continue;
196
- if (messagesChanged)
197
- view.messages = null;
198
323
  const ready = [...view.watchers].filter((watcher) => watcher.ready);
199
324
  if (ready.length === 0)
200
325
  continue;
201
- view.messages ??= shownMessages(conversation, view.limit);
202
- 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);
203
327
  for (const watcher of ready)
204
328
  watcher.notify(value);
205
329
  }
206
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
+ }
207
597
  function live(conversation, change) {
208
- lives.set(conversation, { ...liveOf(conversation), ...change });
209
- 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
+ }
210
626
  }
211
627
  function relayed(conversation, turn, operation) {
212
628
  const held = liveOf(conversation).turn;
@@ -218,7 +634,7 @@ export function createConversationStore(deps) {
218
634
  const held = lives.get(conversation);
219
635
  if (held?.turn == null || !turns.has(held.turn.turn))
220
636
  return false;
221
- lives.set(conversation, { ...held, turn: null });
637
+ setLive(conversation, { ...held, turn: null });
222
638
  return true;
223
639
  }
224
640
  function handReplicated() {
@@ -232,49 +648,96 @@ export function createConversationStore(deps) {
232
648
  handedReplicated = named;
233
649
  stream.replicate(held);
234
650
  }
235
- async function documented() {
236
- const declaration = deps.cards();
237
- if (declaration === undefined)
238
- return [];
239
- const { documents } = await deps.documents(declaration.locator);
240
- return documents.filter((document) => typeof document.type === 'string');
241
- }
242
- function carded(documents) {
243
- const declaration = deps.cards();
244
- if (declaration === undefined)
245
- return [];
246
- const cards = [];
247
- for (const card of documents) {
248
- if (card.type !== declaration.type)
249
- continue;
250
- const identity = card.fields[declaration.identity];
251
- if (typeof identity === 'string')
252
- cards.push({ conversation: identity, card });
253
- }
254
- return cards;
255
- }
256
651
  async function remove(leaving) {
257
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
+ ]);
258
659
  await local.dropConversations(leaving);
259
- const removed = [];
260
660
  const changed = [];
261
661
  for (const conversation of leaving) {
262
- for (const message of messages.get(conversation) ?? []) {
263
- removed.push({ conversation, identity: message.identity });
264
- }
265
- if (messages.has(conversation) || drafts.has(conversation) || lives.has(conversation)) {
662
+ if (kept.has(conversation) || lives.has(conversation))
266
663
  changed.push(conversation);
664
+ for (const view of views.values()) {
665
+ if (view.conversation === conversation)
666
+ view.draft = null;
267
667
  }
268
- messages.delete(conversation);
269
- reads.delete(conversation);
270
- drafts.delete(conversation);
271
668
  behind.delete(conversation);
272
- lives.delete(conversation);
669
+ heardNewest.delete(conversation);
670
+ unsent.delete(conversation);
671
+ setLive(conversation, null);
672
+ await slide(local, conversation, null);
273
673
  }
274
674
  if (changed.length > 0)
275
- deps.publish(conversationChangeSet(removed, changed));
675
+ deps.publish(conversationChangeSet(changed));
276
676
  });
277
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
+ }
278
741
  function gap(conversation) {
279
742
  gaps.set(conversation, (gaps.get(conversation) ?? 0) + 1);
280
743
  behind.add(conversation);
@@ -283,37 +746,32 @@ export function createConversationStore(deps) {
283
746
  return deps.durably(async (local) => {
284
747
  if (!replicated.has(conversation))
285
748
  return;
286
- const read = reads.get(conversation);
749
+ const read = (await readsOf(local, [conversation])).get(conversation)?.read;
287
750
  const advances = read !== undefined &&
288
751
  !behind.has(conversation) &&
289
752
  (read === null || message.position > read);
290
- const sealed = drafts.get(conversation)?.turn === message.turn;
753
+ await sealed(local, conversation, new Set([message.turn]));
291
754
  await local.keepMessages({
292
755
  conversation,
293
756
  messages: [message],
294
- ...(advances ? { read: message.position } : {}),
295
- sealed,
757
+ ...(advances ? { read: { at: message.position, partial: false } } : {}),
296
758
  });
297
- messages.set(conversation, merged(messages.get(conversation) ?? [], [message]));
298
- if (advances)
299
- reads.set(conversation, message.position);
300
- if (sealed)
301
- drafts.delete(conversation);
302
759
  sealTurns(conversation, new Set([message.turn]));
303
- deps.publish(conversationChangeSet([{ conversation, identity: message.identity }], [conversation]));
760
+ await slide(local, conversation, [message]);
761
+ deps.publish(conversationChangeSet([conversation]));
762
+ tellList();
304
763
  });
305
764
  }
306
- async function readHistories(conversations) {
765
+ async function readHistories(conversations, ended) {
307
766
  const generations = new Map(conversations.map((one) => [one, gaps.get(one) ?? 0]));
308
- const starts = new Map(conversations.map((one) => [one, reads.get(one)]));
309
- const arriving = new Map();
310
- const complete = new Set();
311
- let asking = conversations.map((conversation) => ({
767
+ const held = await readsOf(await deps.local(), conversations);
768
+ let waiting = conversations.map((conversation) => ({
312
769
  conversation,
313
- after: starts.get(conversation) ?? undefined,
770
+ after: held.get(conversation)?.read ?? undefined,
314
771
  }));
315
- while (asking.length > 0) {
316
- 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({
317
775
  conversations: asking.map(({ conversation, after }) => ({
318
776
  conversation,
319
777
  ...(after === undefined ? {} : { after }),
@@ -322,183 +780,375 @@ export function createConversationStore(deps) {
322
780
  const pages = historyPages(result);
323
781
  if (pages === null)
324
782
  return result;
325
- const asked = new Set(asking.map(({ conversation }) => conversation));
783
+ const asked = new Map(asking.map(({ conversation, after }) => [conversation, after]));
326
784
  const following = [];
327
785
  for (const page of pages) {
328
786
  if (!asked.has(page.conversation))
329
787
  continue;
330
- arriving.set(page.conversation, [
331
- ...(arriving.get(page.conversation) ?? []),
332
- ...page.messages,
333
- ]);
334
- if (page.next === undefined)
335
- complete.add(page.conversation);
336
- 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) {
337
790
  following.push({ conversation: page.conversation, after: page.next });
791
+ }
338
792
  }
339
- asking = following;
340
- }
341
- for (const [conversation, held] of arriving) {
342
- if (!complete.has(conversation))
343
- continue;
344
- 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];
345
798
  }
346
799
  return null;
347
800
  }
348
- 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) {
349
821
  return deps.durably(async (local) => {
350
822
  if (!replicated.has(conversation))
351
823
  return;
352
- const newest = arriving.reduce((top, message) => (top === null || message.position > top ? message.position : top), from ?? null);
353
- const turn = drafts.get(conversation)?.turn;
354
- const sealed = arriving.some((message) => message.turn === turn);
355
- await local.keepMessages({ conversation, messages: arriving, read: newest, sealed });
356
- messages.set(conversation, merged(messages.get(conversation) ?? [], arriving));
357
- reads.set(conversation, newest);
358
- if (sealed)
359
- 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 } });
360
830
  sealTurns(conversation, new Set(arriving.map((message) => message.turn)));
361
- if ((gaps.get(conversation) ?? 0) === generation)
831
+ if (whole && (gaps.get(conversation) ?? 0) === generation)
362
832
  behind.delete(conversation);
363
- if (arriving.length > 0 || sealed) {
364
- 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]));
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;
365
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]));
366
952
  });
367
953
  }
368
954
  function withDraft(conversation, next) {
369
955
  return deps.durably(async (local) => {
370
- const following = next(drafts.get(conversation));
956
+ const following = await next(await draftAt(local, conversation), local);
371
957
  if (following === undefined)
372
958
  return;
373
- if (following === null) {
374
- await local.dropChatDraft(conversation);
375
- drafts.delete(conversation);
376
- }
377
- else {
378
- await local.keepChatDraft(following);
379
- drafts.set(conversation, following);
380
- }
381
- deps.publish(conversationChangeSet([], [conversation]));
959
+ await kept(local, conversation, following);
960
+ deps.publish(conversationChangeSet([conversation]));
382
961
  });
383
962
  }
384
- function invoke(name, conversation, extra = {}) {
385
- 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 });
386
1018
  }
387
1019
  const surface = {
388
- async list() {
389
- const declaration = deps.cards();
390
- if (declaration === undefined)
391
- return [];
392
- const documents = await documented();
393
- const entries = carded(documents).map(({ conversation, card }) => ({
394
- conversation,
395
- card,
396
- agent: documents.find((document) => document.backlinks.some((backlink) => backlink.path === card.path && backlink.field === declaration.agent)) ?? null,
397
- }));
398
- entries.sort((left, right) => (left.conversation < right.conversation ? -1 : 1));
399
- 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
+ });
400
1030
  },
401
1031
  async read(conversation, options = {}) {
402
- const limit = limitOf(options);
403
- return deps.durably(() => Promise.resolve(viewOf(conversation, limit)));
404
- },
405
- create(input) {
406
- 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
+ });
407
1041
  },
408
- async send(conversation) {
409
- const draft = drafts.get(conversation);
410
- const pending = draft === undefined ? undefined : { draft };
411
- if (pending !== undefined) {
412
- sending.set(conversation, pending);
413
- 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);
414
1050
  }
415
- try {
416
- const files = await Promise.all((draft?.files ?? []).map(async (file) => ({
417
- ...(await declaredFile(file)),
418
- blob: file.blob,
419
- })));
420
- const result = await invoke('conversation.send', conversation, {
421
- text: draft?.text ?? '',
422
- files,
423
- });
424
- const turn = turnOf(result);
425
- if (turn === null || draft === undefined)
426
- return result;
427
- await withDraft(conversation, (current) => {
428
- if (current !== draft)
429
- return undefined;
430
- const sealed = (messages.get(conversation) ?? []).some((message) => message.turn === turn);
431
- 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;
432
1064
  });
433
- return result;
1065
+ if (held === null)
1066
+ return DURABLE_WRITE;
1067
+ return dispatched(conversation, held);
434
1068
  }
435
- finally {
436
- if (pending !== undefined && sending.get(conversation) === pending) {
437
- sending.delete(conversation);
438
- if (drafts.get(conversation) === draft) {
439
- deps.publish(conversationChangeSet([], [conversation]));
440
- }
441
- }
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 ?? []));
442
1073
  }
1074
+ return OFFLINE;
443
1075
  },
444
1076
  answer(conversation, answer) {
445
- return invoke('conversation.answer', conversation, { answer });
1077
+ return invoke('conversations/interaction/answer', conversation, {
1078
+ operation_id: changeBatchIdentity(),
1079
+ ...answer,
1080
+ });
446
1081
  },
447
1082
  interrupt(conversation) {
448
- return invoke('conversation.interrupt', conversation);
1083
+ return invoke('conversations/interrupt', conversation);
449
1084
  },
450
1085
  kill(conversation) {
451
- return invoke('conversation.kill', conversation);
452
- },
453
- async cancel(conversation, turn) {
454
- const result = await invoke('conversation.cancel', conversation, { turn });
455
- if (result.kind !== 'action')
456
- return result;
457
- await withDraft(conversation, (current) => current === undefined || current.turn !== turn ? undefined : { ...current, turn: null });
458
- return result;
1086
+ return invoke('conversations/kill', conversation);
459
1087
  },
460
1088
  delete(conversation) {
461
- return invoke('conversation.delete', conversation);
1089
+ return invoke('conversations/delete', conversation);
462
1090
  },
463
1091
  };
464
1092
  const chatDraft = {
465
- write(conversation, draft) {
466
- return withDraft(conversation, () => ({
1093
+ write(conversation, draft, revision = chatDraftRevision()) {
1094
+ return withDraft(conversation, (current) => ({
467
1095
  conversation,
468
1096
  text: draft.text,
469
- files: [...draft.files],
470
- 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)),
471
1107
  }));
472
1108
  },
473
1109
  discard(conversation) {
474
- return withDraft(conversation, (current) => (current === undefined ? undefined : null));
1110
+ return withDraft(conversation, (current) => current === undefined
1111
+ ? undefined
1112
+ : { conversation, text: '', revision: chatDraftRevision(), ...pending(current) });
475
1113
  },
476
1114
  };
477
1115
  return {
478
1116
  surface,
479
1117
  chatDraft,
480
- hydrate(held, stored) {
481
- messages.clear();
482
- reads.clear();
483
- for (const view of views.values())
484
- view.messages = null;
485
- for (const entry of held) {
486
- messages.set(entry.conversation, [...entry.messages].sort(ordered));
487
- if (entry.read !== undefined)
488
- reads.set(entry.conversation, entry.read);
489
- }
490
- drafts.clear();
491
- for (const record of stored)
492
- 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();
493
1124
  },
494
1125
  async reconcile() {
495
- 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]));
496
1138
  const leaving = [
497
- ...new Set([...replicated, ...messages.keys(), ...reads.keys(), ...drafts.keys()]),
498
- ].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)));
499
1147
  for (const conversation of named) {
500
- if (!replicated.has(conversation))
1148
+ if (!replicated.has(conversation) &&
1149
+ missed(conversation, reads.get(conversation), entries.get(conversation))) {
501
1150
  behind.add(conversation);
1151
+ }
502
1152
  }
503
1153
  replicated = named;
504
1154
  handReplicated();
@@ -506,50 +1156,131 @@ export function createConversationStore(deps) {
506
1156
  await remove(leaving);
507
1157
  },
508
1158
  async catchUp(progress) {
509
- const reading = [...behind].filter((conversation) => replicated.has(conversation)).sort();
510
- if (reading.length > 0 && !deps.closed()) {
511
- 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);
512
1169
  if (failed?.kind === 'transport-uncertainty')
513
1170
  progress.reachable = false;
514
- }
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
+ ]);
515
1178
  if (behind.size > 0)
516
1179
  progress.complete = false;
517
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
+ },
518
1206
  current() {
519
1207
  return behind.size === 0;
520
1208
  },
521
- reconnected() {
522
- for (const conversation of replicated)
523
- 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();
524
1220
  },
525
1221
  watch(conversation, options, deliver) {
526
- const limit = limitOf(options);
527
- 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]);
528
1224
  const view = views.get(key) ?? {
529
1225
  conversation,
530
- limit,
1226
+ asked,
531
1227
  watchers: new Set(),
532
- messages: null,
1228
+ window: null,
1229
+ draft: null,
1230
+ ended: null,
1231
+ marked: [],
1232
+ more: false,
1233
+ total: null,
533
1234
  };
534
1235
  views.set(key, view);
535
1236
  const watcher = { notify: deliver, ready: false };
536
1237
  view.watchers.add(watcher);
537
- void deps
538
- .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)
539
1250
  .then(() => {
540
1251
  if (deps.closed() || !view.watchers.has(watcher))
541
1252
  return;
542
1253
  watcher.ready = true;
543
- 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));
544
1256
  })
545
1257
  .catch(() => { });
546
1258
  return () => {
1259
+ reading.abort();
547
1260
  if (!view.watchers.delete(watcher))
548
1261
  return;
549
1262
  if (view.watchers.size === 0)
550
1263
  views.delete(key);
551
1264
  };
552
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,
553
1284
  changed(set) {
554
1285
  for (const conversation of set.conversations)
555
1286
  emit(conversation);
@@ -557,57 +1288,49 @@ export function createConversationStore(deps) {
557
1288
  receive(event) {
558
1289
  if (deps.closed())
559
1290
  return;
560
- const { conversation } = event;
561
- if (event.kind === 'gap') {
562
- if (replicated.has(conversation))
563
- gap(conversation);
564
- const held = lives.get(conversation);
565
- 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)
566
1299
  return;
567
- lives.set(conversation, { ...QUIET, turn: held.turn });
568
- emit(conversation, false);
569
- return;
570
- }
571
- if (event.kind === 'turn') {
572
- relayed(conversation, event.turn, event.operation);
573
- return;
574
- }
575
- if (event.kind === 'questions') {
576
- live(conversation, { questions: structuredClone(event.questions) });
577
- return;
578
- }
579
- if (event.kind === 'process') {
580
- live(conversation, { process: { running: event.running } });
581
- return;
582
- }
583
- if (event.kind === 'commands') {
584
- 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
+ });
585
1308
  return;
586
1309
  }
587
- if (event.kind === 'options') {
588
- 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 });
589
1313
  return;
590
1314
  }
591
- const arriving = acceptedMessage(event.message);
592
- if (arriving === null)
593
- return;
594
- if (replicated.has(conversation)) {
595
- void keep(conversation, arriving).catch(() => { });
1315
+ if (event.kind === 'unlisted') {
1316
+ relisting?.delete(event.conversation);
1317
+ listChanged({ replacing: false, set: [], gone: event.conversation });
596
1318
  return;
597
1319
  }
598
- if (sealTurns(conversation, new Set([arriving.turn])))
599
- emit(conversation);
600
- },
601
- messages() {
602
- return [...messages].flatMap(([conversation, held]) => held.map(({ identity, text }) => ({ conversation, identity, text })));
603
- },
604
- message(conversation, identity) {
605
- const held = messages.get(conversation)?.find((message) => message.identity === identity);
606
- return held === undefined ? null : { conversation, identity, text: held.text };
1320
+ heard(event);
607
1321
  },
608
1322
  close() {
1323
+ closing.abort();
1324
+ if (rowTimer !== null)
1325
+ clearTimeout(rowTimer);
1326
+ rowTimer = null;
609
1327
  views.clear();
610
1328
  lives.clear();
1329
+ unsent.clear();
1330
+ listWatchers.clear();
1331
+ unlisted.clear();
1332
+ agentWatchers.clear();
1333
+ unnamed.clear();
611
1334
  },
612
1335
  };
613
1336
  }