@ykurilov/agent-chat-core 0.83.2 → 0.84.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,24 @@
1
1
  # @ykurilov/agent-chat-core
2
2
 
3
+ ## 0.84.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 5e90be0: Добавлен opt-in первый срез бесед с внешним исполнителем: текст сохраняется до отправки, недоступный исполнитель получает очередь после восстановления, ответ и разрешения приходят через сохранённый журнал. Исходный clientMessageId проверяется при повторе. Новые публичные входы core/external, server/external и storage-sqlite/external не меняют прежний ChatService.
8
+
9
+ В checkout SDK добавлены локальные SPM-продукты AgentChatClient и AgentChatOduvanchik для iOS 17/macOS 14: история, поток, отдельные разрешения, «Стоп», переподключение и очередь на устройстве. Канонический YKDesign подключается отдельно по локальному пути. Переносимого публичного SPM URL пока нет.
10
+
11
+ ### Как обновить приложение
12
+
13
+ 1. Старые приложения не требуют изменений. Для внешнего исполнителя в серверном composition root подключите новые /external входы, создайте SQLite conversation store, сервис и fetch handler. Существующее ChatStorage не заменяйте.
14
+ 2. При старте provision разрешённых бесед и service.start; при завершении await service.close до store.close. Адаптер обязан подтверждать async sink после записи, поддерживать reconcile и отдельный stopTurn. Полный договор - docs/external-native.md.
15
+ 3. В Xcode подключите локальный SDK package и канонический YKDesign, передайте endpoint, accountID, cacheURL и credential closure в AgentChatClient. Авторизация, список разрешённых привязок и политика кеша остаются приложению.
16
+ 4. Проверьте недоступного исполнителя, повтор одного clientMessageId, переподключение, разрешение и остановку. Не включайте kind:model: встроенный нативный модельный исполнитель отложен. Перед production подтвердите на Мосте поиск исходного ID при неопределённой отправке; без доказательства SDK не повторяет внешнее действие.
17
+
18
+ ## 0.83.3
19
+
20
+ No changes in this release.
21
+
3
22
  ## 0.83.2
4
23
 
5
24
  ### Patch Changes
@@ -0,0 +1,560 @@
1
+ // src/external/types.ts
2
+ var ExternalDispatchRejected = class extends Error {
3
+ code = "external_dispatch_rejected";
4
+ };
5
+ function isExternalDispatchRejected(error) {
6
+ return error instanceof ExternalDispatchRejected || !!(error && typeof error === "object" && "code" in error && error.code === "external_dispatch_rejected");
7
+ }
8
+
9
+ // src/external/store.ts
10
+ function conversationView(s) {
11
+ return {
12
+ id: s.definition.id,
13
+ title: s.definition.title,
14
+ pinned: s.definition.pinned === true,
15
+ execution: { kind: s.definition.execution.kind },
16
+ ...s.definition.modelChoice && { modelChoice: structuredClone(s.definition.modelChoice) },
17
+ updatedAt: s.updatedAt,
18
+ connection: s.connection
19
+ };
20
+ }
21
+ function initialConversation(definition) {
22
+ if (!definition.id || !definition.ownerId || !definition.title || !definition.execution.id || !["external", "model"].includes(definition.execution.kind)) throw Error("invalid_conversation");
23
+ return { definition: structuredClone(definition), updatedAt: (/* @__PURE__ */ new Date()).toISOString(), connection: "offline", turn: { status: "idle", generation: 0 }, messages: [], permissions: [], events: [], cursor: 0 };
24
+ }
25
+ function createMemoryConversationStore() {
26
+ const records = /* @__PURE__ */ new Map();
27
+ const own = (ownerId, id) => {
28
+ const state = records.get(id);
29
+ if (!state || state.definition.ownerId !== ownerId) throw Error("not_found");
30
+ return state;
31
+ };
32
+ return {
33
+ guarded: true,
34
+ async create(d) {
35
+ const old = records.get(d.id);
36
+ if (old) {
37
+ if (old.definition.ownerId !== d.ownerId) throw Error("not_found");
38
+ if (JSON.stringify(old.definition.execution) !== JSON.stringify(d.execution)) throw Error("execution_conflict");
39
+ return;
40
+ }
41
+ records.set(d.id, initialConversation(d));
42
+ },
43
+ async list(ownerId) {
44
+ return [...records.values()].filter((s) => s.definition.ownerId === ownerId).map(conversationView).sort((a, b) => Number(b.pinned) - Number(a.pinned) || b.updatedAt.localeCompare(a.updatedAt));
45
+ },
46
+ async read(ownerId, id) {
47
+ return structuredClone(own(ownerId, id));
48
+ },
49
+ async transaction(ownerId, id, change) {
50
+ const next = structuredClone(own(ownerId, id));
51
+ const result = change(next);
52
+ if (result && typeof result === "object" && "then" in result) throw Error("async_transaction_forbidden");
53
+ records.set(id, next);
54
+ return structuredClone(result);
55
+ }
56
+ };
57
+ }
58
+
59
+ // src/external/service.ts
60
+ import { randomUUID } from "crypto";
61
+ function createExternalConversationService(options) {
62
+ if (options.store.guarded !== true) throw TypeError("ConversationStore must implement guarded atomic transactions");
63
+ const { store } = options, now = options.now ?? Date.now, leaseMs = options.leaseMs ?? 3e4;
64
+ if (leaseMs < 100) throw TypeError("leaseMs must be at least 100");
65
+ const active = /* @__PURE__ */ new Map();
66
+ const starts = /* @__PURE__ */ new Map();
67
+ const log = options.logError ?? (() => {
68
+ });
69
+ let closed = false;
70
+ const assertActive = (a) => {
71
+ if (closed || a.lost) throw Error("lease_lost");
72
+ };
73
+ const ownLease = (state, a) => {
74
+ if (closed || a.lost || state.lease?.holder !== a.holder || state.lease.expiresAt <= now()) throw Error("lease_lost");
75
+ };
76
+ const emit = (s, change) => {
77
+ s.updatedAt = new Date(now()).toISOString();
78
+ s.events.push({ ...structuredClone(change), version: 1, chatId: s.definition.id, seq: ++s.cursor });
79
+ const keep = options.retainedEvents ?? 1024;
80
+ if (s.events.length > keep) s.events.splice(0, s.events.length - keep);
81
+ };
82
+ const messageChanged = (s, m) => {
83
+ m.revision++;
84
+ emit(s, { type: "message", message: m });
85
+ };
86
+ const permissionChanged = (s, p) => {
87
+ p.revision++;
88
+ emit(s, { type: "permission", permission: p });
89
+ };
90
+ const statusChanged = (s) => emit(s, { type: "status", connection: s.connection, turn: s.turn });
91
+ const guarded = (id, a, change) => store.transaction(a.ownerId, id, (s) => {
92
+ ownLease(s, a);
93
+ return change(s);
94
+ });
95
+ async function bounded(work) {
96
+ let timer;
97
+ try {
98
+ return await Promise.race([work, new Promise((_, reject) => {
99
+ timer = setTimeout(() => reject(Error("executor_timeout")), options.commandTimeoutMs ?? 3e4);
100
+ })]);
101
+ } finally {
102
+ clearTimeout(timer);
103
+ }
104
+ }
105
+ function upsertPermission(s, request) {
106
+ const old = s.permissions.find((p2) => p2.id === request.id);
107
+ if (old) {
108
+ if (old.status === "resolved") return;
109
+ const next = { ...old, ...structuredClone(request) };
110
+ if (JSON.stringify(old) !== JSON.stringify(next)) {
111
+ Object.assign(old, next);
112
+ permissionChanged(s, old);
113
+ }
114
+ return;
115
+ }
116
+ const p = { ...structuredClone(request), revision: 0, status: "open" };
117
+ s.permissions.push(p);
118
+ permissionChanged(s, p);
119
+ }
120
+ async function ingest(id, a, event) {
121
+ await guarded(id, a, (s) => {
122
+ switch (event.type) {
123
+ case "history_reset":
124
+ s.epoch = event.epoch;
125
+ break;
126
+ case "message":
127
+ case "delta": {
128
+ const complete = event.type === "message";
129
+ const incoming = complete ? event.message : { id: event.id, role: "assistant", text: event.textSoFar, createdAt: new Date(now()).toISOString() };
130
+ if (!incoming.id || incoming.id.length > 200 || typeof incoming.text !== "string" || incoming.text.length > 1e5 || !Number.isFinite(Date.parse(incoming.createdAt))) throw Error("invalid_external_message");
131
+ const role = incoming.role === "manager" ? "assistant" : incoming.role;
132
+ let m = s.messages.find((m2) => m2.id === incoming.id || m2.aliases.some((x) => x.id === incoming.id));
133
+ if (!m && complete && event.rebuilt) {
134
+ if (!s.epoch) throw Error("rebuilt_requires_history_reset");
135
+ m = s.messages.find((m2) => m2.role === role && m2.text === incoming.text && Math.abs(Date.parse(m2.createdAt) - Date.parse(incoming.createdAt)) <= 2e3 && !m2.aliases.some((x) => x.epoch === s.epoch));
136
+ }
137
+ if (!m) {
138
+ m = { id: incoming.id, role, text: "", createdAt: incoming.createdAt, revision: 0, status: complete ? "complete" : "streaming", aliases: [] };
139
+ s.messages.push(m);
140
+ }
141
+ if (m.role !== role) throw Error("external_message_identity_conflict");
142
+ if (m.delivery && m.text !== incoming.text) throw Error("external_message_identity_conflict");
143
+ const before = JSON.stringify(m);
144
+ const alias = m.aliases.find((x) => x.id === incoming.id);
145
+ if (alias) {
146
+ if (s.epoch) alias.epoch = s.epoch;
147
+ else delete alias.epoch;
148
+ } else m.aliases.push({ id: incoming.id, ...s.epoch && { epoch: s.epoch } });
149
+ if (!m.text.startsWith(incoming.text) || incoming.text.length >= m.text.length) m.text = incoming.text;
150
+ if (complete) {
151
+ m.createdAt = incoming.createdAt;
152
+ m.status = "complete";
153
+ if (role === "user") m.delivery = "sent";
154
+ } else if (m.status !== "complete") m.status = "streaming";
155
+ if (before !== JSON.stringify(m) || m.revision === 0) messageChanged(s, m);
156
+ break;
157
+ }
158
+ case "status":
159
+ if (event.manager === "offline") a.ready = false;
160
+ if (s.connection !== event.manager) {
161
+ s.connection = event.manager;
162
+ statusChanged(s);
163
+ }
164
+ break;
165
+ case "turn_started":
166
+ s.turn = { status: "running", generation: s.turn.generation + 1 };
167
+ statusChanged(s);
168
+ break;
169
+ case "turn_ended": {
170
+ s.turn = { status: event.outcome === "completed" ? "idle" : event.outcome === "canceled" ? "stopped" : event.outcome === "failed" ? "error" : "unknown", generation: s.turn.generation, ...event.error && { error: event.error } };
171
+ for (const m of s.messages.filter((m2) => m2.status === "streaming")) {
172
+ m.status = event.outcome === "canceled" ? "stopped" : event.outcome === "failed" ? "error" : event.outcome === "unknown" ? "unknown" : "complete";
173
+ messageChanged(s, m);
174
+ }
175
+ statusChanged(s);
176
+ break;
177
+ }
178
+ case "permission_requested":
179
+ upsertPermission(s, event.request);
180
+ break;
181
+ case "permission_resolved": {
182
+ const p = s.permissions.find((p2) => p2.id === event.requestId);
183
+ if (p && p.status !== "resolved") {
184
+ p.status = "resolved";
185
+ permissionChanged(s, p);
186
+ }
187
+ break;
188
+ }
189
+ case "permissions_snapshot": {
190
+ const ids = new Set(event.requests.map((r) => r.id));
191
+ for (const p of s.permissions) if (p.status !== "resolved" && !ids.has(p.id)) {
192
+ p.status = "resolved";
193
+ permissionChanged(s, p);
194
+ }
195
+ for (const p of event.requests) upsertPermission(s, p);
196
+ break;
197
+ }
198
+ }
199
+ });
200
+ }
201
+ function scheduleDrain(id, a) {
202
+ void drain(id, a).catch(log);
203
+ }
204
+ async function drain(id, a) {
205
+ if (a.lost || closed || !a.ready) return;
206
+ if (a.drain) return a.drain;
207
+ const work = (async () => {
208
+ while (!a.lost && !closed && a.ready && a.executor.status() !== "offline") {
209
+ const next = await guarded(id, a, (s) => {
210
+ if (s.messages.some((m2) => m2.delivery === "unknown" || m2.delivery === "sending")) return null;
211
+ const m = s.messages.find((m2) => m2.delivery === "queued");
212
+ if (!m) return null;
213
+ m.delivery = "sending";
214
+ messageChanged(s, m);
215
+ return { id: m.id, text: m.text };
216
+ });
217
+ if (!next) return;
218
+ try {
219
+ assertActive(a);
220
+ await bounded(a.executor.send(next.text, next.id));
221
+ await guarded(id, a, (s) => {
222
+ const m = s.messages.find((m2) => m2.id === next.id);
223
+ if (m.delivery === "sending") {
224
+ m.delivery = "sent";
225
+ messageChanged(s, m);
226
+ }
227
+ });
228
+ } catch (error) {
229
+ await guarded(id, a, (s) => {
230
+ const m = s.messages.find((m2) => m2.id === next.id);
231
+ if (m.delivery === "sending") {
232
+ m.delivery = isExternalDispatchRejected(error) ? "queued" : "unknown";
233
+ messageChanged(s, m);
234
+ }
235
+ });
236
+ log(error);
237
+ return;
238
+ }
239
+ }
240
+ })();
241
+ a.drain = work;
242
+ try {
243
+ await work;
244
+ } finally {
245
+ if (a.drain === work) a.drain = void 0;
246
+ }
247
+ }
248
+ async function start(ownerId, id) {
249
+ if (closed) throw Error("service_closed");
250
+ const existing = active.get(id);
251
+ if (existing) {
252
+ if (existing.ownerId !== ownerId) throw Error("not_found");
253
+ return;
254
+ }
255
+ if (starts.has(id)) {
256
+ await starts.get(id);
257
+ await store.read(ownerId, id);
258
+ return;
259
+ }
260
+ const work = (async () => {
261
+ const state = await store.read(ownerId, id);
262
+ if (state.definition.execution.kind !== "external") throw Error("executor_not_supported");
263
+ const executor = await bounded(Promise.resolve(options.resolveExecutor(state.definition)));
264
+ if (closed) throw Error("service_closed");
265
+ const a = { ownerId, executor, holder: randomUUID(), tail: Promise.resolve(), off: () => {
266
+ }, lost: false, decisions: /* @__PURE__ */ new Map(), ready: false, nextReconcileAt: 0, reconcileFailures: 0 };
267
+ await store.transaction(ownerId, id, (s) => {
268
+ if (s.lease && s.lease.expiresAt > now()) throw Error("busy");
269
+ s.lease = { holder: a.holder, expiresAt: now() + leaseMs };
270
+ for (const m of s.messages) if (m.delivery === "sending") {
271
+ m.delivery = "unknown";
272
+ messageChanged(s, m);
273
+ }
274
+ });
275
+ if (closed) {
276
+ await store.transaction(ownerId, id, (s) => {
277
+ if (s.lease?.holder === a.holder) delete s.lease;
278
+ });
279
+ throw Error("service_closed");
280
+ }
281
+ active.set(id, a);
282
+ try {
283
+ a.off = executor.onConversation((event) => {
284
+ const work2 = a.tail.then(() => ingest(id, a, event));
285
+ a.tail = work2.catch(log);
286
+ void work2.then(() => {
287
+ if (event.type === "status" && event.manager !== "offline" && !a.reconcile) void reconcile(ownerId, id).catch(log);
288
+ }, () => {
289
+ });
290
+ return work2;
291
+ });
292
+ let renewing = false;
293
+ a.timer = setInterval(() => {
294
+ if (renewing || a.lost) return;
295
+ renewing = true;
296
+ void guarded(id, a, (s) => {
297
+ s.lease.expiresAt = now() + leaseMs;
298
+ }).then(() => {
299
+ if (!a.ready && a.executor.status() !== "offline" && now() >= a.nextReconcileAt) void reconcile(ownerId, id).catch(log);
300
+ else if (a.ready) scheduleDrain(id, a);
301
+ }, (error) => {
302
+ a.lost = true;
303
+ a.off();
304
+ clearInterval(a.timer);
305
+ if (active.get(id) === a) active.delete(id);
306
+ log(error);
307
+ }).finally(() => {
308
+ renewing = false;
309
+ });
310
+ }, Math.min(options.pollMs ?? 1e3, Math.floor(leaseMs / 3)));
311
+ a.timer.unref?.();
312
+ await reconcile(ownerId, id).catch(log);
313
+ if (closed) throw Error("service_closed");
314
+ } catch (error) {
315
+ clearInterval(a.timer);
316
+ a.off();
317
+ active.delete(id);
318
+ await store.transaction(ownerId, id, (s) => {
319
+ if (s.lease?.holder === a.holder) delete s.lease;
320
+ });
321
+ throw error;
322
+ }
323
+ })();
324
+ starts.set(id, work);
325
+ try {
326
+ await work;
327
+ } finally {
328
+ starts.delete(id);
329
+ }
330
+ }
331
+ async function reconcile(ownerId, id) {
332
+ const a = active.get(id);
333
+ if (!a) {
334
+ await start(ownerId, id);
335
+ return;
336
+ }
337
+ if (a.ownerId !== ownerId) throw Error("not_found");
338
+ if (a.reconcile) return a.reconcile;
339
+ const work = (async () => {
340
+ if (a.replay) {
341
+ await bounded(a.replay);
342
+ await a.tail;
343
+ }
344
+ assertActive(a);
345
+ const replay = Promise.resolve().then(() => {
346
+ assertActive(a);
347
+ return a.executor.reconcile();
348
+ });
349
+ a.replay = replay;
350
+ const settled = () => {
351
+ if (a.replay === replay) a.replay = void 0;
352
+ };
353
+ void replay.then(settled, settled);
354
+ await bounded(replay);
355
+ await a.tail;
356
+ const current = a.executor.status();
357
+ await guarded(id, a, (s) => {
358
+ const before = JSON.stringify(s.turn);
359
+ if (current === "thinking" || current === "waiting_approval") {
360
+ if (s.turn.status !== "running") s.turn = { status: "running", generation: s.turn.generation + 1 };
361
+ delete s.turn.stopRequested;
362
+ delete s.stop;
363
+ } else if (current === "idle" && s.turn.status === "running") {
364
+ s.turn = { status: "unknown", generation: s.turn.generation };
365
+ for (const m of s.messages.filter((m2) => m2.status === "streaming")) {
366
+ m.status = "unknown";
367
+ messageChanged(s, m);
368
+ }
369
+ delete s.stop;
370
+ }
371
+ if (before !== JSON.stringify(s.turn)) statusChanged(s);
372
+ });
373
+ a.ready = current !== "offline";
374
+ a.reconcileFailures = 0;
375
+ a.nextReconcileAt = 0;
376
+ await drain(id, a);
377
+ const pending = (await store.read(ownerId, id)).permissions.filter((p) => p.status === "responding" && p.decision);
378
+ for (const p of pending) await dispatchDecision(id, a, p.id, p.decision);
379
+ })();
380
+ a.reconcile = work;
381
+ try {
382
+ await work;
383
+ } catch (error) {
384
+ a.ready = false;
385
+ a.nextReconcileAt = now() + Math.min(3e4, 1e3 * 2 ** Math.min(a.reconcileFailures++, 5));
386
+ await guarded(id, a, (s) => {
387
+ if (s.connection !== "offline") {
388
+ s.connection = "offline";
389
+ statusChanged(s);
390
+ }
391
+ });
392
+ throw error;
393
+ } finally {
394
+ if (a.reconcile === work) a.reconcile = void 0;
395
+ }
396
+ }
397
+ async function dispatchDecision(id, a, requestId, decision) {
398
+ const pending = a.decisions.get(requestId);
399
+ if (pending) return pending;
400
+ const work = performDecision(id, a, requestId, decision);
401
+ a.decisions.set(requestId, work);
402
+ try {
403
+ await work;
404
+ } finally {
405
+ if (a.decisions.get(requestId) === work) a.decisions.delete(requestId);
406
+ }
407
+ }
408
+ async function performDecision(id, a, requestId, decision) {
409
+ if (!a.ready || a.executor.status() === "offline") return;
410
+ const response = await guarded(id, a, (s) => {
411
+ const p = s.permissions.find((p2) => p2.id === requestId);
412
+ if (!p || p.status !== "responding") return null;
413
+ return permissionResponse(p, decision);
414
+ });
415
+ if (response) try {
416
+ assertActive(a);
417
+ await bounded(a.executor.respondToPermission(requestId, response));
418
+ } catch (error) {
419
+ log(error);
420
+ }
421
+ }
422
+ function permissionResponse(p, d) {
423
+ if (!d || typeof d !== "object" || Array.isArray(d)) throw Error("invalid_permission_answer");
424
+ const fields = [d.answers !== void 0, d.actionId !== void 0, d.behavior !== void 0].filter(Boolean).length;
425
+ if (fields !== 1) throw Error("invalid_permission_answer");
426
+ const isQuestion = p.kind === "question" || p.name === "AskUserQuestion";
427
+ if (d.answers) {
428
+ const questions = p.input?.questions;
429
+ if (!isQuestion || !Array.isArray(questions) || typeof d.answers !== "object" || Array.isArray(d.answers) || Object.values(d.answers).some((v) => typeof v !== "string" || !v.trim())) throw Error("invalid_permission_answer");
430
+ const allowed = new Set(questions.map((q) => typeof q === "object" && q !== null && "question" in q ? q.question : void 0));
431
+ if (allowed.size === 0 || allowed.has(void 0) || Object.keys(d.answers).some((q) => !allowed.has(q)) || [...allowed].some((q) => typeof q !== "string" || !d.answers?.[q]?.trim())) throw Error("invalid_permission_answer");
432
+ return { behavior: "allow", updatedInput: { questions, answers: d.answers } };
433
+ }
434
+ if (d.actionId) {
435
+ const action = p.actions?.find((a) => a.id === d.actionId);
436
+ if (!action) throw Error("invalid_permission_action");
437
+ if (isQuestion && action.behavior === "allow") throw Error("invalid_permission_answer");
438
+ return { behavior: action.behavior, selectedActionId: action.id };
439
+ }
440
+ if (p.actions?.length || !d.behavior || isQuestion && d.behavior !== "deny") throw Error("invalid_permission_action");
441
+ return { behavior: d.behavior };
442
+ }
443
+ return {
444
+ ensureConversation: (d) => store.create(d),
445
+ list: (ownerId) => store.list(ownerId),
446
+ start,
447
+ reconcile,
448
+ async snapshot(ownerId, id) {
449
+ const s = await store.read(ownerId, id);
450
+ return { version: 1, conversation: conversationView(s), cursor: s.cursor, messages: s.messages, permissions: s.permissions, turn: s.turn };
451
+ },
452
+ async events(ownerId, id, after) {
453
+ if (!Number.isSafeInteger(after) || after < 0) throw Error("invalid_cursor");
454
+ const s = await store.read(ownerId, id);
455
+ const reset = after > s.cursor || s.events.length > 0 && after < s.events[0].seq - 1;
456
+ return { version: 1, reset, cursor: s.cursor, events: reset ? [] : s.events.filter((e) => e.seq > after) };
457
+ },
458
+ async send(ownerId, id, input) {
459
+ if (!input.clientMessageId || input.clientMessageId.length > 200 || !input.text.trim() || input.text.length > 1e5) throw Error("invalid_message");
460
+ const receipt = await store.transaction(ownerId, id, (s) => {
461
+ if (s.definition.execution.kind !== "external") throw Error("executor_not_supported");
462
+ const old = s.messages.find((m2) => m2.id === input.clientMessageId);
463
+ if (old) {
464
+ if (old.role !== "user" || old.text !== input.text) throw Error("message_id_conflict");
465
+ return { messageId: old.id, delivery: old.delivery ?? "sent" };
466
+ }
467
+ const m = { id: input.clientMessageId, role: "user", text: input.text, createdAt: new Date(now()).toISOString(), revision: 0, delivery: "queued", status: "complete", aliases: [] };
468
+ s.messages.push(m);
469
+ messageChanged(s, m);
470
+ return { messageId: m.id, delivery: m.delivery };
471
+ });
472
+ const a = active.get(id);
473
+ if (a) scheduleDrain(id, a);
474
+ return receipt;
475
+ },
476
+ async answerPermission(ownerId, id, requestId, commandId, decision) {
477
+ if (!commandId || commandId.length > 200) throw Error("invalid_command");
478
+ await store.transaction(ownerId, id, (s) => {
479
+ const p = s.permissions.find((p2) => p2.id === requestId);
480
+ if (!p) throw Error("not_found");
481
+ const withId = p;
482
+ if (withId.commandId === commandId) {
483
+ if (stableJSON(p.decision) !== stableJSON(decision)) throw Error("command_id_conflict");
484
+ return;
485
+ }
486
+ if (p.status !== "open") throw Error("permission_not_pending");
487
+ permissionResponse(p, decision);
488
+ withId.commandId = commandId;
489
+ p.decision = structuredClone(decision);
490
+ p.status = "responding";
491
+ permissionChanged(s, p);
492
+ });
493
+ const a = active.get(id);
494
+ if (a) await dispatchDecision(id, a, requestId, decision);
495
+ return { accepted: true };
496
+ },
497
+ async stop(ownerId, id, commandId) {
498
+ const a = active.get(id);
499
+ if (!a || !a.ready || a.ownerId !== ownerId || a.executor.status() === "offline") throw Error("executor_offline");
500
+ const needed = await guarded(id, a, (s) => {
501
+ const state = s;
502
+ if (!commandId || commandId.length > 200) throw Error("invalid_command");
503
+ if (state.stop?.generation === s.turn.generation) return false;
504
+ if (s.turn.status !== "running") return false;
505
+ state.stop = { id: commandId, generation: s.turn.generation };
506
+ s.turn.stopRequested = true;
507
+ statusChanged(s);
508
+ return true;
509
+ });
510
+ if (needed) try {
511
+ assertActive(a);
512
+ await bounded(a.executor.stopTurn());
513
+ } catch (error) {
514
+ await guarded(id, a, (s) => {
515
+ const state = s;
516
+ if (state.stop?.id === commandId && state.stop.generation === s.turn.generation) {
517
+ delete state.stop;
518
+ delete s.turn.stopRequested;
519
+ statusChanged(s);
520
+ }
521
+ });
522
+ throw error;
523
+ }
524
+ return { requested: needed };
525
+ },
526
+ async close() {
527
+ closed = true;
528
+ for (const a of active.values()) {
529
+ a.lost = true;
530
+ a.off();
531
+ clearInterval(a.timer);
532
+ }
533
+ await Promise.allSettled([...starts.values()]);
534
+ await Promise.all([...active].map(async ([id, a]) => {
535
+ a.lost = true;
536
+ a.off();
537
+ clearInterval(a.timer);
538
+ await a.tail;
539
+ await store.transaction(a.ownerId, id, (s) => {
540
+ if (s.lease?.holder === a.holder) delete s.lease;
541
+ });
542
+ }));
543
+ active.clear();
544
+ }
545
+ };
546
+ }
547
+ function stableJSON(value) {
548
+ if (Array.isArray(value)) return "[" + value.map(stableJSON).join(",") + "]";
549
+ if (value && typeof value === "object") return "{" + Object.keys(value).sort().map((key) => JSON.stringify(key) + ":" + stableJSON(value[key])).join(",") + "}";
550
+ return JSON.stringify(value) ?? "undefined";
551
+ }
552
+ export {
553
+ ExternalDispatchRejected,
554
+ conversationView,
555
+ createExternalConversationService,
556
+ createMemoryConversationStore,
557
+ initialConversation,
558
+ isExternalDispatchRejected
559
+ };
560
+ //# sourceMappingURL=external.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/external/types.ts","../src/external/store.ts","../src/external/service.ts"],"sourcesContent":["/** Versioned native conversation protocol. Independent of model providers and UIMessageChunk. */\nexport type ConnectionStatus = \"idle\" | \"thinking\" | \"waiting_approval\" | \"offline\";\nexport type DeliveryStatus = \"queued\" | \"sending\" | \"unknown\" | \"sent\";\nexport interface ConversationDefinition {\n id: string; ownerId: string; title: string; pinned?: boolean;\n execution: { kind: \"external\" | \"model\"; id: string };\n modelChoice?: { modelId: string; providerId: string; reasoning?: string };\n}\nexport interface ConversationMessage {\n id: string; role: \"user\" | \"assistant\" | \"system\"; text: string; createdAt: string; revision: number;\n delivery?: DeliveryStatus;\n status: \"complete\" | \"streaming\" | \"stopped\" | \"error\" | \"unknown\";\n aliases: Array<{id:string; epoch?:string}>;\n}\nexport interface ExternalPermissionRequest {\n id: string; name: string; kind: string; title?: string; description?: string;\n input?: Record<string, unknown>;\n actions?: Array<{id:string;label:string;behavior:\"allow\"|\"deny\"}>;\n}\nexport interface PermissionDecision { actionId?: string; behavior?: \"allow\" | \"deny\"; answers?: Record<string,string> }\nexport type ExternalPermissionResponse =\n | {behavior:\"allow\";selectedActionId?:string;updatedInput?:Record<string,unknown>}\n | {behavior:\"deny\";selectedActionId?:string};\nexport interface ConversationPermission extends ExternalPermissionRequest {\n revision: number; status: \"open\" | \"responding\" | \"resolved\"; decision?: PermissionDecision;\n}\nexport interface ExternalMessage {id:string;role:\"user\"|\"manager\"|\"assistant\"|\"system\";text:string;createdAt:string}\nexport type ExternalConversationEvent =\n | {type:\"message\";message:ExternalMessage;rebuilt?:boolean}\n | {type:\"delta\";id:string;textSoFar:string}\n | {type:\"turn_started\"}\n | {type:\"turn_ended\";outcome:\"completed\"|\"canceled\"|\"failed\"|\"unknown\";error?:string}\n | {type:\"status\";manager:ConnectionStatus}\n | {type:\"permission_requested\";request:ExternalPermissionRequest}\n | {type:\"permission_resolved\";requestId:string}\n | {type:\"permissions_snapshot\";requests:ExternalPermissionRequest[]}\n /** Required before a rebuilt replay; epoch is stable across restart of the bridge. */\n | {type:\"history_reset\";epoch:string};\nexport interface ExternalExecutor {\n status(): ConnectionStatus;\n send(text:string,messageId:string):Promise<void>;\n stopTurn():Promise<void>;\n respondToPermission(requestId:string,response:ExternalPermissionResponse):Promise<void>;\n /** The source MUST await this promise before advancing its durable source cursor. */\n onConversation(listener:(event:ExternalConversationEvent)=>Promise<void>):()=>void;\n /** Replay/reconcile through the same ordered, acknowledged sink, then resolve. Include permissions_snapshot. */\n reconcile():Promise<void>;\n}\n/** Use only when the transport can prove no submission was accepted. Ordinary failures are ambiguous. */\nexport class ExternalDispatchRejected extends Error {\n readonly code=\"external_dispatch_rejected\" as const;\n}\n/** Explicit adapter assertion of proven non-acceptance; works across duplicate package copies. */\nexport function isExternalDispatchRejected(error:unknown):boolean {\n return error instanceof ExternalDispatchRejected || !!(error&&typeof error===\"object\"&&\"code\" in error&&error.code===\"external_dispatch_rejected\");\n}\nexport interface ConversationView {\n id:string;title:string;pinned:boolean;execution:{kind:\"external\"|\"model\"};modelChoice?:ConversationDefinition[\"modelChoice\"];\n updatedAt:string;connection:ConnectionStatus;\n}\nexport interface ConversationTurn {status:\"idle\"|\"running\"|\"stopped\"|\"error\"|\"unknown\";generation:number;stopRequested?:boolean;error?:string}\nexport type ConversationChange =\n | {type:\"message\";message:ConversationMessage}\n | {type:\"permission\";permission:ConversationPermission}\n | {type:\"status\";connection:ConnectionStatus;turn:ConversationTurn};\nexport type ConversationFeedEvent = ConversationChange & {version:1;seq:number;chatId:string};\nexport interface ConversationSnapshot {version:1;conversation:ConversationView;cursor:number;messages:ConversationMessage[];permissions:ConversationPermission[];turn:ConversationTurn}\nexport interface ConversationState {\n definition:ConversationDefinition;updatedAt:string;connection:ConnectionStatus;turn:ConversationTurn;\n messages:ConversationMessage[];permissions:ConversationPermission[];cursor:number;events:ConversationFeedEvent[];\n epoch?:string;lease?:{holder:string;expiresAt:number};\n}\n/** Atomic synchronous callback: exceptions roll back all projection and journal writes together. Never await inside. */\nexport interface ConversationStore {\n readonly guarded:true;\n create(definition:ConversationDefinition):Promise<void>;\n list(ownerId:string):Promise<ConversationView[]>;\n read(ownerId:string,chatId:string):Promise<ConversationState>;\n transaction<T>(ownerId:string,chatId:string,change:(state:ConversationState)=>T):Promise<T>;\n}\n","import type { ConversationDefinition, ConversationState, ConversationStore, ConversationView } from \"./types\";\nexport function conversationView(s:ConversationState):ConversationView {\n return {id:s.definition.id,title:s.definition.title,pinned:s.definition.pinned===true,execution:{kind:s.definition.execution.kind},\n ...(s.definition.modelChoice&&{modelChoice:structuredClone(s.definition.modelChoice)}),updatedAt:s.updatedAt,connection:s.connection};\n}\nexport function initialConversation(definition:ConversationDefinition):ConversationState {\n if(!definition.id||!definition.ownerId||!definition.title||!definition.execution.id||![\"external\",\"model\"].includes(definition.execution.kind))throw Error(\"invalid_conversation\");\n return {definition:structuredClone(definition),updatedAt:new Date().toISOString(),connection:\"offline\",turn:{status:\"idle\",generation:0},messages:[],permissions:[],events:[],cursor:0};\n}\nexport function createMemoryConversationStore():ConversationStore {\n const records=new Map<string,ConversationState>();\n const own=(ownerId:string,id:string)=>{const state=records.get(id);if(!state||state.definition.ownerId!==ownerId)throw Error(\"not_found\");return state;};\n return {guarded:true,\n async create(d){const old=records.get(d.id);if(old){if(old.definition.ownerId!==d.ownerId)throw Error(\"not_found\");if(JSON.stringify(old.definition.execution)!==JSON.stringify(d.execution))throw Error(\"execution_conflict\");return;}records.set(d.id,initialConversation(d));},\n async list(ownerId){return [...records.values()].filter(s=>s.definition.ownerId===ownerId).map(conversationView).sort((a,b)=>Number(b.pinned)-Number(a.pinned)||b.updatedAt.localeCompare(a.updatedAt));},\n async read(ownerId,id){return structuredClone(own(ownerId,id));},\n async transaction(ownerId,id,change){const next=structuredClone(own(ownerId,id));const result=change(next);if(result&&typeof result===\"object\"&&\"then\" in result)throw Error(\"async_transaction_forbidden\");records.set(id,next);return structuredClone(result);},\n };\n}\n","import { randomUUID } from \"node:crypto\";\nimport { conversationView } from \"./store\";\nimport { isExternalDispatchRejected } from \"./types\";\nimport type { ConversationChange, ConversationDefinition, ConversationFeedEvent, ConversationMessage, ConversationPermission, ConversationSnapshot, ConversationState, ConversationStore, ExternalConversationEvent, ExternalExecutor, ExternalPermissionRequest, ExternalPermissionResponse, PermissionDecision } from \"./types\";\n\ninterface Active {\n ownerId:string; executor:ExternalExecutor; holder:string; tail:Promise<unknown>; off:()=>void;\n timer?:ReturnType<typeof setInterval>; drain?:Promise<void>; reconcile?:Promise<void>; replay?:Promise<void>; decisions:Map<string,Promise<void>>; ready:boolean; nextReconcileAt:number; reconcileFailures:number; lost:boolean;\n}\nexport interface ExternalConversationOptions {\n store:ConversationStore;\n resolveExecutor(definition:ConversationDefinition):ExternalExecutor|Promise<ExternalExecutor>;\n now?:()=>number; leaseMs?:number; pollMs?:number; commandTimeoutMs?:number; retainedEvents?:number;\n logError?:(error:unknown)=>void;\n}\n/** Durable client projection. The executor remains authoritative about execution and permission outcomes. */\nexport function createExternalConversationService(options:ExternalConversationOptions) {\n if(options.store.guarded!==true)throw TypeError(\"ConversationStore must implement guarded atomic transactions\");\n const {store}=options, now=options.now??Date.now, leaseMs=options.leaseMs??30_000;\n if(leaseMs<100)throw TypeError(\"leaseMs must be at least 100\");\n const active=new Map<string,Active>();\n const starts=new Map<string,Promise<void>>();\n const log=options.logError??(()=>{});\n let closed=false;\n const assertActive=(a:Active)=>{if(closed||a.lost)throw Error(\"lease_lost\");};\n const ownLease=(state:ConversationState,a:Active)=>{\n if(closed||a.lost||state.lease?.holder!==a.holder||state.lease.expiresAt<=now())throw Error(\"lease_lost\");\n };\n const emit=(s:ConversationState,change:ConversationChange)=>{\n s.updatedAt=new Date(now()).toISOString();\n s.events.push({...structuredClone(change),version:1,chatId:s.definition.id,seq:++s.cursor});\n const keep=options.retainedEvents??1024;\n if(s.events.length>keep)s.events.splice(0,s.events.length-keep);\n };\n const messageChanged=(s:ConversationState,m:ConversationMessage)=>{m.revision++;emit(s,{type:\"message\",message:m});};\n const permissionChanged=(s:ConversationState,p:ConversationPermission)=>{p.revision++;emit(s,{type:\"permission\",permission:p});};\n const statusChanged=(s:ConversationState)=>emit(s,{type:\"status\",connection:s.connection,turn:s.turn});\n const guarded=<T>(id:string,a:Active,change:(s:ConversationState)=>T)=>store.transaction(a.ownerId,id,s=>{ownLease(s,a);return change(s);});\n async function bounded<T>(work:Promise<T>):Promise<T> {\n let timer:ReturnType<typeof setTimeout>|undefined;\n try{return await Promise.race([work,new Promise<never>((_,reject)=>{timer=setTimeout(()=>reject(Error(\"executor_timeout\")),options.commandTimeoutMs??30_000);})]);}\n finally{clearTimeout(timer);}\n }\n function upsertPermission(s:ConversationState,request:ExternalPermissionRequest) {\n const old=s.permissions.find(p=>p.id===request.id);\n if(old){if(old.status===\"resolved\")return;const next={...old,...structuredClone(request)};if(JSON.stringify(old)!==JSON.stringify(next)){Object.assign(old,next);permissionChanged(s,old);}return;}\n const p:ConversationPermission={...structuredClone(request),revision:0,status:\"open\"};s.permissions.push(p);permissionChanged(s,p);\n }\n async function ingest(id:string,a:Active,event:ExternalConversationEvent) {\n await guarded(id,a,s=>{\n switch(event.type){\n case \"history_reset\":s.epoch=event.epoch;break;\n case \"message\":case \"delta\":{\n const complete=event.type===\"message\";\n const incoming=complete?event.message:{id:event.id,role:\"assistant\" as const,text:event.textSoFar,createdAt:new Date(now()).toISOString()};\n if(!incoming.id||incoming.id.length>200||typeof incoming.text!==\"string\"||incoming.text.length>100_000||!Number.isFinite(Date.parse(incoming.createdAt)))throw Error(\"invalid_external_message\");\n const role=incoming.role===\"manager\"?\"assistant\":incoming.role;\n let m=s.messages.find(m=>m.id===incoming.id||m.aliases.some(x=>x.id===incoming.id));\n if(!m&&complete&&event.rebuilt){\n if(!s.epoch)throw Error(\"rebuilt_requires_history_reset\");\n // Ordered one-to-one matching within the new epoch, never text-only set deduplication.\n m=s.messages.find(m=>m.role===role&&m.text===incoming.text&&Math.abs(Date.parse(m.createdAt)-Date.parse(incoming.createdAt))<=2000&&!m.aliases.some(x=>x.epoch===s.epoch));\n }\n if(!m){m={id:incoming.id,role,text:\"\",createdAt:incoming.createdAt,revision:0,status:complete?\"complete\":\"streaming\",aliases:[]};s.messages.push(m);}\n if(m.role!==role)throw Error(\"external_message_identity_conflict\");\n if(m.delivery&&m.text!==incoming.text)throw Error(\"external_message_identity_conflict\");\n const before=JSON.stringify(m);\n const alias=m.aliases.find(x=>x.id===incoming.id);\n if(alias){if(s.epoch)alias.epoch=s.epoch;else delete alias.epoch;}\n else m.aliases.push({id:incoming.id,...(s.epoch&&{epoch:s.epoch})});\n // A replay of an older cumulative prefix cannot truncate a newer saved answer.\n if(!m.text.startsWith(incoming.text)||incoming.text.length>=m.text.length)m.text=incoming.text;\n if(complete){m.createdAt=incoming.createdAt;m.status=\"complete\";if(role===\"user\")m.delivery=\"sent\";}\n else if(m.status!==\"complete\")m.status=\"streaming\";\n if(before!==JSON.stringify(m)||m.revision===0)messageChanged(s,m);\n break;\n }\n case \"status\":if(event.manager===\"offline\")a.ready=false;if(s.connection!==event.manager){s.connection=event.manager;statusChanged(s);}break;\n case \"turn_started\":s.turn={status:\"running\",generation:s.turn.generation+1};statusChanged(s);break;\n case \"turn_ended\":{\n s.turn={status:event.outcome===\"completed\"?\"idle\":event.outcome===\"canceled\"?\"stopped\":event.outcome===\"failed\"?\"error\":\"unknown\",generation:s.turn.generation,...(event.error&&{error:event.error})};\n for(const m of s.messages.filter(m=>m.status===\"streaming\")){m.status=event.outcome===\"canceled\"?\"stopped\":event.outcome===\"failed\"?\"error\":event.outcome===\"unknown\"?\"unknown\":\"complete\";messageChanged(s,m);}\n statusChanged(s);break;\n }\n case \"permission_requested\":upsertPermission(s,event.request);break;\n case \"permission_resolved\":{const p=s.permissions.find(p=>p.id===event.requestId);if(p&&p.status!==\"resolved\"){p.status=\"resolved\";permissionChanged(s,p);}break;}\n case \"permissions_snapshot\":{\n const ids=new Set(event.requests.map(r=>r.id));\n for(const p of s.permissions)if(p.status!==\"resolved\"&&!ids.has(p.id)){p.status=\"resolved\";permissionChanged(s,p);}\n for(const p of event.requests)upsertPermission(s,p);break;\n }\n }\n });\n }\n function scheduleDrain(id:string,a:Active) { void drain(id,a).catch(log); }\n async function drain(id:string,a:Active):Promise<void> {\n if(a.lost||closed||!a.ready)return;\n if(a.drain)return a.drain;\n const work=(async()=>{\n while(!a.lost&&!closed&&a.ready&&a.executor.status()!==\"offline\"){\n const next=await guarded(id,a,s=>{\n if(s.messages.some(m=>m.delivery===\"unknown\"||m.delivery===\"sending\"))return null;\n const m=s.messages.find(m=>m.delivery===\"queued\");if(!m)return null;\n m.delivery=\"sending\";messageChanged(s,m);return {id:m.id,text:m.text};\n });\n if(!next)return;\n try {\n assertActive(a);await bounded(a.executor.send(next.text,next.id));\n await guarded(id,a,s=>{const m=s.messages.find(m=>m.id===next.id)!;if(m.delivery===\"sending\"){m.delivery=\"sent\";messageChanged(s,m);}});\n } catch(error) {\n await guarded(id,a,s=>{const m=s.messages.find(m=>m.id===next.id)!;if(m.delivery===\"sending\"){m.delivery=isExternalDispatchRejected(error)?\"queued\":\"unknown\";messageChanged(s,m);}});\n log(error);return;\n }\n }\n })();\n a.drain=work;\n try{await work;}finally{if(a.drain===work)a.drain=undefined;}\n }\n async function start(ownerId:string,id:string):Promise<void> {\n if(closed)throw Error(\"service_closed\");\n const existing=active.get(id);if(existing){if(existing.ownerId!==ownerId)throw Error(\"not_found\");return;}\n if(starts.has(id)){await starts.get(id);await store.read(ownerId,id);return;}\n const work=(async()=>{\n const state=await store.read(ownerId,id);\n if(state.definition.execution.kind!==\"external\")throw Error(\"executor_not_supported\");\n const executor=await bounded(Promise.resolve(options.resolveExecutor(state.definition)));\n if(closed)throw Error(\"service_closed\");\n const a:Active={ownerId,executor,holder:randomUUID(),tail:Promise.resolve(),off:()=>{},lost:false,decisions:new Map(),ready:false,nextReconcileAt:0,reconcileFailures:0};\n await store.transaction(ownerId,id,s=>{\n if(s.lease&&s.lease.expiresAt>now())throw Error(\"busy\");\n s.lease={holder:a.holder,expiresAt:now()+leaseMs};\n for(const m of s.messages)if(m.delivery===\"sending\"){m.delivery=\"unknown\";messageChanged(s,m);}\n });\n if(closed){await store.transaction(ownerId,id,s=>{if(s.lease?.holder===a.holder)delete s.lease;});throw Error(\"service_closed\");}\n active.set(id,a);\n try {\n a.off=executor.onConversation(event=>{\n const work=a.tail.then(()=>ingest(id,a,event));a.tail=work.catch(log);\n // The returned promise is the commit acknowledgement, not a queued receipt.\n void work.then(()=>{\n if(event.type===\"status\"&&event.manager!==\"offline\"&&!a.reconcile)void reconcile(ownerId,id).catch(log);\n },()=>{});\n return work;\n });\n let renewing=false;\n a.timer=setInterval(()=>{\n if(renewing||a.lost)return;renewing=true;\n void guarded(id,a,s=>{s.lease!.expiresAt=now()+leaseMs;}).then(()=>{\n if(!a.ready&&a.executor.status()!==\"offline\"&&now()>=a.nextReconcileAt)void reconcile(ownerId,id).catch(log);\n else if(a.ready)scheduleDrain(id,a);\n },error=>{a.lost=true;a.off();clearInterval(a.timer);if(active.get(id)===a)active.delete(id);log(error);}).finally(()=>{renewing=false;});\n },Math.min(options.pollMs??1000,Math.floor(leaseMs/3)));\n a.timer.unref?.();\n // Keep the lease and acknowledged subscription during a transient offline startup.\n await reconcile(ownerId,id).catch(log);\n if(closed)throw Error(\"service_closed\");\n } catch(error) {\n clearInterval(a.timer);a.off();active.delete(id);\n await store.transaction(ownerId,id,s=>{if(s.lease?.holder===a.holder)delete s.lease;});throw error;\n }\n })();\n starts.set(id,work);try{await work;}finally{starts.delete(id);}\n }\n async function reconcile(ownerId:string,id:string):Promise<void> {\n const a=active.get(id);if(!a){await start(ownerId,id);return;}\n if(a.ownerId!==ownerId)throw Error(\"not_found\");\n if(a.reconcile)return a.reconcile;\n const work=(async()=>{\n // A retained replay belongs to a timed-out call. It is only a barrier, never a fresh result.\n if(a.replay){await bounded(a.replay);await a.tail;}\n assertActive(a);\n const replay=Promise.resolve().then(()=>{assertActive(a);return a.executor.reconcile();});a.replay=replay;\n const settled=()=>{if(a.replay===replay)a.replay=undefined;};\n void replay.then(settled,settled);\n await bounded(replay);await a.tail;\n const current=a.executor.status();\n await guarded(id,a,s=>{\n const before=JSON.stringify(s.turn);\n if(current===\"thinking\"||current===\"waiting_approval\"){\n if(s.turn.status!==\"running\")s.turn={status:\"running\",generation:s.turn.generation+1};\n // A snapshot confirms that execution is still active, not that an earlier Stop succeeded.\n delete s.turn.stopRequested;delete (s as ConversationState&{stop?:unknown}).stop;\n }else if(current===\"idle\"&&s.turn.status===\"running\"){\n s.turn={status:\"unknown\",generation:s.turn.generation};\n for(const m of s.messages.filter(m=>m.status===\"streaming\")){m.status=\"unknown\";messageChanged(s,m);}\n delete (s as ConversationState&{stop?:unknown}).stop;\n }\n if(before!==JSON.stringify(s.turn))statusChanged(s);\n });\n a.ready=current!==\"offline\";a.reconcileFailures=0;a.nextReconcileAt=0;\n // Source replay confirms accepted client ids; ambiguous missing sends stay unknown.\n await drain(id,a);\n const pending=(await store.read(ownerId,id)).permissions.filter(p=>p.status===\"responding\"&&p.decision);\n for(const p of pending)await dispatchDecision(id,a,p.id,p.decision!);\n })();\n a.reconcile=work;try{await work;}catch(error){\n a.ready=false;a.nextReconcileAt=now()+Math.min(30_000,1000*2**Math.min(a.reconcileFailures++,5));\n await guarded(id,a,s=>{if(s.connection!==\"offline\"){s.connection=\"offline\";statusChanged(s);}});\n throw error;\n }finally{if(a.reconcile===work)a.reconcile=undefined;}\n }\n async function dispatchDecision(id:string,a:Active,requestId:string,decision:PermissionDecision) {\n const pending=a.decisions.get(requestId);if(pending)return pending;\n const work=performDecision(id,a,requestId,decision);a.decisions.set(requestId,work);\n try{await work;}finally{if(a.decisions.get(requestId)===work)a.decisions.delete(requestId);}\n }\n async function performDecision(id:string,a:Active,requestId:string,decision:PermissionDecision) {\n if(!a.ready||a.executor.status()===\"offline\")return;\n const response=await guarded(id,a,s=>{\n const p=s.permissions.find(p=>p.id===requestId);if(!p||p.status!==\"responding\")return null;\n return permissionResponse(p,decision);\n });\n if(response)try{assertActive(a);await bounded(a.executor.respondToPermission(requestId,response));}catch(error){log(error);}\n }\n function permissionResponse(p:ConversationPermission,d:PermissionDecision):ExternalPermissionResponse {\n if(!d||typeof d!==\"object\"||Array.isArray(d))throw Error(\"invalid_permission_answer\");\n const fields=[d.answers!==undefined,d.actionId!==undefined,d.behavior!==undefined].filter(Boolean).length;\n if(fields!==1)throw Error(\"invalid_permission_answer\");\n const isQuestion=p.kind===\"question\"||p.name===\"AskUserQuestion\";\n if(d.answers){\n const questions=p.input?.questions;\n if(!isQuestion||!Array.isArray(questions)||typeof d.answers!==\"object\"||Array.isArray(d.answers)||Object.values(d.answers).some(v=>typeof v!==\"string\"||!v.trim()))throw Error(\"invalid_permission_answer\");\n const allowed=new Set(questions.map(q=>typeof q===\"object\"&&q!==null&&\"question\" in q?q.question:undefined));\n if(allowed.size===0||allowed.has(undefined)||Object.keys(d.answers).some(q=>!allowed.has(q))||[...allowed].some(q=>typeof q!==\"string\"||!d.answers?.[q]?.trim()))throw Error(\"invalid_permission_answer\");\n return {behavior:\"allow\",updatedInput:{questions,answers:d.answers}};\n }\n if(d.actionId){const action=p.actions?.find(a=>a.id===d.actionId);if(!action)throw Error(\"invalid_permission_action\");if(isQuestion&&action.behavior===\"allow\")throw Error(\"invalid_permission_answer\");return {behavior:action.behavior,selectedActionId:action.id};}\n if(p.actions?.length||!d.behavior||(isQuestion&&d.behavior!==\"deny\"))throw Error(\"invalid_permission_action\");\n return {behavior:d.behavior};\n }\n return {\n ensureConversation:(d:ConversationDefinition)=>store.create(d),\n list:(ownerId:string)=>store.list(ownerId),start,reconcile,\n async snapshot(ownerId:string,id:string):Promise<ConversationSnapshot>{const s=await store.read(ownerId,id);return {version:1,conversation:conversationView(s),cursor:s.cursor,messages:s.messages,permissions:s.permissions,turn:s.turn};},\n async events(ownerId:string,id:string,after:number):Promise<{version:1;reset:boolean;cursor:number;events:ConversationFeedEvent[]}>{\n if(!Number.isSafeInteger(after)||after<0)throw Error(\"invalid_cursor\");const s=await store.read(ownerId,id);\n const reset=after>s.cursor||(s.events.length>0&&after<s.events[0]!.seq-1);\n return {version:1,reset,cursor:s.cursor,events:reset?[]:s.events.filter(e=>e.seq>after)};\n },\n async send(ownerId:string,id:string,input:{clientMessageId:string;text:string}){\n if(!input.clientMessageId||input.clientMessageId.length>200||!input.text.trim()||input.text.length>100_000)throw Error(\"invalid_message\");\n const receipt=await store.transaction(ownerId,id,s=>{\n if(s.definition.execution.kind!==\"external\")throw Error(\"executor_not_supported\");\n const old=s.messages.find(m=>m.id===input.clientMessageId);\n if(old){if(old.role!==\"user\"||old.text!==input.text)throw Error(\"message_id_conflict\");return {messageId:old.id,delivery:old.delivery??\"sent\"};}\n const m:ConversationMessage={id:input.clientMessageId,role:\"user\",text:input.text,createdAt:new Date(now()).toISOString(),revision:0,delivery:\"queued\",status:\"complete\",aliases:[]};s.messages.push(m);messageChanged(s,m);return {messageId:m.id,delivery:m.delivery!};\n });\n const a=active.get(id);if(a)scheduleDrain(id,a);\n return receipt;\n },\n async answerPermission(ownerId:string,id:string,requestId:string,commandId:string,decision:PermissionDecision){\n if(!commandId||commandId.length>200)throw Error(\"invalid_command\");\n await store.transaction(ownerId,id,s=>{\n const p=s.permissions.find(p=>p.id===requestId);if(!p)throw Error(\"not_found\");\n const withId=p as ConversationPermission&{commandId?:string};\n if(withId.commandId===commandId){if(stableJSON(p.decision)!==stableJSON(decision))throw Error(\"command_id_conflict\");return;}\n if(p.status!==\"open\")throw Error(\"permission_not_pending\");permissionResponse(p,decision);\n withId.commandId=commandId;p.decision=structuredClone(decision);p.status=\"responding\";permissionChanged(s,p);\n });\n const a=active.get(id);if(a)await dispatchDecision(id,a,requestId,decision);\n return {accepted:true};\n },\n async stop(ownerId:string,id:string,commandId:string){\n const a=active.get(id);if(!a||!a.ready||a.ownerId!==ownerId||a.executor.status()===\"offline\")throw Error(\"executor_offline\");\n const needed=await guarded(id,a,s=>{\n const state=s as ConversationState&{stop?:{id:string;generation:number}};\n if(!commandId||commandId.length>200)throw Error(\"invalid_command\");\n if(state.stop?.generation===s.turn.generation)return false;if(s.turn.status!==\"running\")return false;\n state.stop={id:commandId,generation:s.turn.generation};s.turn.stopRequested=true;statusChanged(s);return true;\n });\n if(needed)try{assertActive(a);await bounded(a.executor.stopTurn());}catch(error){\n await guarded(id,a,s=>{const state=s as ConversationState&{stop?:{id:string;generation:number}};if(state.stop?.id===commandId&&state.stop.generation===s.turn.generation){delete state.stop;delete s.turn.stopRequested;statusChanged(s);}});throw error;\n }return {requested:needed};\n },\n async close(){closed=true;\n for(const a of active.values()){a.lost=true;a.off();clearInterval(a.timer);}\n await Promise.allSettled([...starts.values()]);\n await Promise.all([...active].map(async([id,a])=>{a.lost=true;a.off();clearInterval(a.timer);await a.tail;await store.transaction(a.ownerId,id,s=>{if(s.lease?.holder===a.holder)delete s.lease;});}));active.clear();},\n };\n}\nexport type ExternalConversationService=ReturnType<typeof createExternalConversationService>;\n\nfunction stableJSON(value:unknown):string {\n if(Array.isArray(value))return \"[\"+value.map(stableJSON).join(\",\")+\"]\";\n if(value&&typeof value===\"object\")return \"{\"+Object.keys(value).sort().map(key=>JSON.stringify(key)+\":\"+stableJSON((value as Record<string,unknown>)[key])).join(\",\")+\"}\";\n return JSON.stringify(value)??\"undefined\";\n}\n"],"mappings":"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","names":["p","m","work"]}
@@ -0,0 +1,40 @@
1
+ import type { ConversationDefinition, ConversationFeedEvent, ConversationSnapshot, ConversationStore, ExternalExecutor, PermissionDecision } from "./types.js";
2
+ export interface ExternalConversationOptions {
3
+ store: ConversationStore;
4
+ resolveExecutor(definition: ConversationDefinition): ExternalExecutor | Promise<ExternalExecutor>;
5
+ now?: () => number;
6
+ leaseMs?: number;
7
+ pollMs?: number;
8
+ commandTimeoutMs?: number;
9
+ retainedEvents?: number;
10
+ logError?: (error: unknown) => void;
11
+ }
12
+ /** Durable client projection. The executor remains authoritative about execution and permission outcomes. */
13
+ export declare function createExternalConversationService(options: ExternalConversationOptions): {
14
+ ensureConversation: (d: ConversationDefinition) => Promise<void>;
15
+ list: (ownerId: string) => Promise<import("./types.js").ConversationView[]>;
16
+ start: (ownerId: string, id: string) => Promise<void>;
17
+ reconcile: (ownerId: string, id: string) => Promise<void>;
18
+ snapshot(ownerId: string, id: string): Promise<ConversationSnapshot>;
19
+ events(ownerId: string, id: string, after: number): Promise<{
20
+ version: 1;
21
+ reset: boolean;
22
+ cursor: number;
23
+ events: ConversationFeedEvent[];
24
+ }>;
25
+ send(ownerId: string, id: string, input: {
26
+ clientMessageId: string;
27
+ text: string;
28
+ }): Promise<{
29
+ messageId: string;
30
+ delivery: import("./types.js").DeliveryStatus;
31
+ }>;
32
+ answerPermission(ownerId: string, id: string, requestId: string, commandId: string, decision: PermissionDecision): Promise<{
33
+ accepted: boolean;
34
+ }>;
35
+ stop(ownerId: string, id: string, commandId: string): Promise<{
36
+ requested: boolean;
37
+ }>;
38
+ close(): Promise<void>;
39
+ };
40
+ export type ExternalConversationService = ReturnType<typeof createExternalConversationService>;
@@ -0,0 +1,4 @@
1
+ import type { ConversationDefinition, ConversationState, ConversationStore, ConversationView } from "./types.js";
2
+ export declare function conversationView(s: ConversationState): ConversationView;
3
+ export declare function initialConversation(definition: ConversationDefinition): ConversationState;
4
+ export declare function createMemoryConversationStore(): ConversationStore;
@@ -0,0 +1,180 @@
1
+ /** Versioned native conversation protocol. Independent of model providers and UIMessageChunk. */
2
+ export type ConnectionStatus = "idle" | "thinking" | "waiting_approval" | "offline";
3
+ export type DeliveryStatus = "queued" | "sending" | "unknown" | "sent";
4
+ export interface ConversationDefinition {
5
+ id: string;
6
+ ownerId: string;
7
+ title: string;
8
+ pinned?: boolean;
9
+ execution: {
10
+ kind: "external" | "model";
11
+ id: string;
12
+ };
13
+ modelChoice?: {
14
+ modelId: string;
15
+ providerId: string;
16
+ reasoning?: string;
17
+ };
18
+ }
19
+ export interface ConversationMessage {
20
+ id: string;
21
+ role: "user" | "assistant" | "system";
22
+ text: string;
23
+ createdAt: string;
24
+ revision: number;
25
+ delivery?: DeliveryStatus;
26
+ status: "complete" | "streaming" | "stopped" | "error" | "unknown";
27
+ aliases: Array<{
28
+ id: string;
29
+ epoch?: string;
30
+ }>;
31
+ }
32
+ export interface ExternalPermissionRequest {
33
+ id: string;
34
+ name: string;
35
+ kind: string;
36
+ title?: string;
37
+ description?: string;
38
+ input?: Record<string, unknown>;
39
+ actions?: Array<{
40
+ id: string;
41
+ label: string;
42
+ behavior: "allow" | "deny";
43
+ }>;
44
+ }
45
+ export interface PermissionDecision {
46
+ actionId?: string;
47
+ behavior?: "allow" | "deny";
48
+ answers?: Record<string, string>;
49
+ }
50
+ export type ExternalPermissionResponse = {
51
+ behavior: "allow";
52
+ selectedActionId?: string;
53
+ updatedInput?: Record<string, unknown>;
54
+ } | {
55
+ behavior: "deny";
56
+ selectedActionId?: string;
57
+ };
58
+ export interface ConversationPermission extends ExternalPermissionRequest {
59
+ revision: number;
60
+ status: "open" | "responding" | "resolved";
61
+ decision?: PermissionDecision;
62
+ }
63
+ export interface ExternalMessage {
64
+ id: string;
65
+ role: "user" | "manager" | "assistant" | "system";
66
+ text: string;
67
+ createdAt: string;
68
+ }
69
+ export type ExternalConversationEvent = {
70
+ type: "message";
71
+ message: ExternalMessage;
72
+ rebuilt?: boolean;
73
+ } | {
74
+ type: "delta";
75
+ id: string;
76
+ textSoFar: string;
77
+ } | {
78
+ type: "turn_started";
79
+ } | {
80
+ type: "turn_ended";
81
+ outcome: "completed" | "canceled" | "failed" | "unknown";
82
+ error?: string;
83
+ } | {
84
+ type: "status";
85
+ manager: ConnectionStatus;
86
+ } | {
87
+ type: "permission_requested";
88
+ request: ExternalPermissionRequest;
89
+ } | {
90
+ type: "permission_resolved";
91
+ requestId: string;
92
+ } | {
93
+ type: "permissions_snapshot";
94
+ requests: ExternalPermissionRequest[];
95
+ }
96
+ /** Required before a rebuilt replay; epoch is stable across restart of the bridge. */
97
+ | {
98
+ type: "history_reset";
99
+ epoch: string;
100
+ };
101
+ export interface ExternalExecutor {
102
+ status(): ConnectionStatus;
103
+ send(text: string, messageId: string): Promise<void>;
104
+ stopTurn(): Promise<void>;
105
+ respondToPermission(requestId: string, response: ExternalPermissionResponse): Promise<void>;
106
+ /** The source MUST await this promise before advancing its durable source cursor. */
107
+ onConversation(listener: (event: ExternalConversationEvent) => Promise<void>): () => void;
108
+ /** Replay/reconcile through the same ordered, acknowledged sink, then resolve. Include permissions_snapshot. */
109
+ reconcile(): Promise<void>;
110
+ }
111
+ /** Use only when the transport can prove no submission was accepted. Ordinary failures are ambiguous. */
112
+ export declare class ExternalDispatchRejected extends Error {
113
+ readonly code: "external_dispatch_rejected";
114
+ }
115
+ /** Explicit adapter assertion of proven non-acceptance; works across duplicate package copies. */
116
+ export declare function isExternalDispatchRejected(error: unknown): boolean;
117
+ export interface ConversationView {
118
+ id: string;
119
+ title: string;
120
+ pinned: boolean;
121
+ execution: {
122
+ kind: "external" | "model";
123
+ };
124
+ modelChoice?: ConversationDefinition["modelChoice"];
125
+ updatedAt: string;
126
+ connection: ConnectionStatus;
127
+ }
128
+ export interface ConversationTurn {
129
+ status: "idle" | "running" | "stopped" | "error" | "unknown";
130
+ generation: number;
131
+ stopRequested?: boolean;
132
+ error?: string;
133
+ }
134
+ export type ConversationChange = {
135
+ type: "message";
136
+ message: ConversationMessage;
137
+ } | {
138
+ type: "permission";
139
+ permission: ConversationPermission;
140
+ } | {
141
+ type: "status";
142
+ connection: ConnectionStatus;
143
+ turn: ConversationTurn;
144
+ };
145
+ export type ConversationFeedEvent = ConversationChange & {
146
+ version: 1;
147
+ seq: number;
148
+ chatId: string;
149
+ };
150
+ export interface ConversationSnapshot {
151
+ version: 1;
152
+ conversation: ConversationView;
153
+ cursor: number;
154
+ messages: ConversationMessage[];
155
+ permissions: ConversationPermission[];
156
+ turn: ConversationTurn;
157
+ }
158
+ export interface ConversationState {
159
+ definition: ConversationDefinition;
160
+ updatedAt: string;
161
+ connection: ConnectionStatus;
162
+ turn: ConversationTurn;
163
+ messages: ConversationMessage[];
164
+ permissions: ConversationPermission[];
165
+ cursor: number;
166
+ events: ConversationFeedEvent[];
167
+ epoch?: string;
168
+ lease?: {
169
+ holder: string;
170
+ expiresAt: number;
171
+ };
172
+ }
173
+ /** Atomic synchronous callback: exceptions roll back all projection and journal writes together. Never await inside. */
174
+ export interface ConversationStore {
175
+ readonly guarded: true;
176
+ create(definition: ConversationDefinition): Promise<void>;
177
+ list(ownerId: string): Promise<ConversationView[]>;
178
+ read(ownerId: string, chatId: string): Promise<ConversationState>;
179
+ transaction<T>(ownerId: string, chatId: string, change: (state: ConversationState) => T): Promise<T>;
180
+ }
@@ -0,0 +1,4 @@
1
+ export * from "./external/types.js";
2
+ export { createMemoryConversationStore, initialConversation, conversationView } from "./external/store.js";
3
+ export { createExternalConversationService } from "./external/service.js";
4
+ export type { ExternalConversationService, ExternalConversationOptions } from "./external/service.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ykurilov/agent-chat-core",
3
- "version": "0.83.2",
3
+ "version": "0.84.0",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -25,6 +25,11 @@
25
25
  "@ykurilov/agent-chat-source": "./src/storage/storage-contract.ts",
26
26
  "types": "./dist/types/storage/storage-contract.d.ts",
27
27
  "import": "./dist/storage-contract.js"
28
+ },
29
+ "./external": {
30
+ "@ykurilov/agent-chat-source": "./src/external.ts",
31
+ "types": "./dist/types/external.d.ts",
32
+ "import": "./dist/external.js"
28
33
  }
29
34
  },
30
35
  "engines": {