@agentshouse/mdruntime 0.1.0-ca6edc1abd618 → 0.1.0-ca92b54804c33

package/dist/conversation.js

@@ -1,10 +1,11 @@
+import { cursorOf, decodedCursor } from '@agentshouse/mdmodel';
 import { conversationChangeSet } from './change-set.js';
 import { runtimeError } from './failure.js';
 import { refusedForSpace } from './durability.js';
-import { declaredFile } from './file.js';
 import { changeBatchIdentity, chatDraftRevision } from './identity.js';
 import { OFFLINE } from './outcome.js';
-import { capped, cursorOf, decodedCursor, FROM_START, messageOrder, precedes } from './windows.js';
+import { untilAnswered } from './recovery.js';
+import { capped, FROM_START, messageOrder, precedes } from './windows.js';
 const QUIET = {
     turn: null,
     questions: [],
@@ -12,6 +13,7 @@ const QUIET = {
     commands: [],
     options: [],
     starting: null,
+    subagents: [],
     link: null,
     deliveryUnknown: [],
 };
@@ -21,6 +23,7 @@ const FACTS = [
     'commands',
     'options',
     'starting',
+    'subagents',
     'link',
     'deliveryUnknown',
 ];
@@ -31,9 +34,11 @@ export function unheldView(conversation) {
         turn: null,
         questions: [],
         process: null,
+        processEnded: null,
         commands: [],
         options: [],
         starting: null,
+        subagents: [],
         link: null,
         deliveryUnknown: [],
         chatDraft: null,
@@ -48,10 +53,8 @@ export function newChat(agent) {
 function creationOf(input) {
     if (typeof input !== 'object' || input === null)
         return null;
-    const { agent_id: agent, operation_id: operation, replaces, } = input;
-    return typeof agent === 'string' && typeof operation === 'string' && replaces === undefined
-        ? { agent, operation }
-        : null;
+    const { agent_id: agent, operation_id: operation } = input;
+    return typeof agent === 'string' && typeof operation === 'string' ? { agent, operation } : null;
 }
 function startedTurn(turn, operation) {
     if (operation.op === 'begin')
@@ -210,7 +213,14 @@ function askedOf(options) {
     }
     return { limit: capped(limit), after, before: beforeOf(after), total: total === true };
 }
-const EXPIRED = { kind: 'rejected', code: 'expired', fields: {}, retryable: false };
+function phraseOf(text) {
+    if (text === undefined)
+        return null;
+    if (typeof text !== 'string' || text === '') {
+        throw runtimeError('invalid-text', 'a conversation is found by a phrase');
+    }
+    return text;
+}
 const DURABLE_WRITE = {
     kind: 'rejected',
     code: 'durable-write',
@@ -244,10 +254,6 @@ function returned(draft, submission, others) {
     }, others);
 }
 export function createConversationStore(deps) {
-    const stored = new Set();
-    const reads = new Map();
-    const partials = new Set();
-    const drafts = new Map();
     const sending = new Map();
     const behind = new Set();
     const catching = new Map();
@@ -255,21 +261,23 @@ export function createConversationStore(deps) {
     const lives = new Map();
     const unsent = new Map();
     const views = new Map();
-    const listing = new Map();
+    const heardNewest = new Map();
+    let relisting = null;
     const creations = new Set();
     const listWatchers = new Set();
+    const unlisted = new Set();
     let listKnown = false;
     const agentWatchers = new Set();
-    let agentNames = new Map();
-    let retiredAgents = new Set();
-    let agentsRead = null;
+    const unnamed = new Set();
+    let agentsShown = null;
+    let listedAgents = null;
+    let agentsReading = false;
     let replicated = new Set();
     let handedReplicated;
     function liveOf(conversation) {
         return lives.get(conversation) ?? QUIET;
     }
-    function viewOf(conversation, held, frame) {
-        const draft = drafts.get(conversation);
+    function viewOf(conversation, held, frame, draft, ended) {
         const facts = liveOf(conversation);
         return {
             conversation,
@@ -283,14 +291,14 @@ export function createConversationStore(deps) {
             turn: structuredClone(facts.turn),
             questions: structuredClone(facts.questions),
             process: facts.process === null ? null : { ...facts.process },
+            processEnded: ended,
             commands: structuredClone(facts.commands),
             options: structuredClone(facts.options),
             starting: facts.starting,
+            subagents: structuredClone(facts.subagents),
             link: facts.link === null ? null : { ...facts.link },
             deliveryUnknown: [...facts.deliveryUnknown],
-            chatDraft: draft === undefined || unwritten(draft)
-                ? null
-                : { text: draft.text, revision: draft.revision },
+            chatDraft: draft === null || unwritten(draft) ? null : { text: draft.text, revision: draft.revision },
         };
     }
     function emit(conversation) {
@@ -302,7 +310,7 @@ export function createConversationStore(deps) {
             const ready = [...view.watchers].filter((watcher) => watcher.ready);
             if (ready.length === 0)
                 continue;
-            const value = viewOf(conversation, view.window, sharedFrame(view, view.window));
+            const value = viewOf(conversation, view.window, sharedFrame(view, view.window), view.draft, view.ended);
             for (const watcher of ready)
                 watcher.notify(value);
         }
@@ -338,10 +346,10 @@ export function createConversationStore(deps) {
             return 'asking';
         return facts.turn === null ? 'idle' : 'working';
     }
-    function entries() {
-        return [...listing.values()].map((entry) => ({
+    function entries(list) {
+        return list.map((entry) => ({
             conversation: entry.conversation,
-            agent: { identity: entry.agent, name: agentNames.get(entry.agent) ?? null },
+            agent: { identity: entry.agent, name: entry.agentName },
             name: entry.name,
             created: entry.created,
             finished: entry.finished,
@@ -351,27 +359,160 @@ export function createConversationStore(deps) {
             started: lives.get(entry.conversation)?.turn?.started ?? null,
         }));
     }
+    async function heldList() {
+        const stored = (await (await deps.local()).facts()).conversationList;
+        if (stored !== null)
+            return stored;
+        return !listKnown && deps.stream() !== undefined && deps.online() ? null : [];
+    }
+    async function endedIn(conversation) {
+        const list = await heldList();
+        return list?.find((entry) => entry.conversation === conversation)?.processEnded ?? null;
+    }
+    function listChanged(change) {
+        void deps
+            .durably(async (local) => {
+            const { conversationList, conversationCursor } = await local.facts();
+            const kept = change.replacing ? [] : (conversationList ?? []);
+            const held = new Map(kept.map((entry) => [entry.conversation, entry]));
+            for (const entry of change.set) {
+                held.set(entry.conversation, { ...entry });
+                creations.delete(entry.conversation);
+            }
+            if (change.gone !== null)
+                held.delete(change.gone);
+            const list = [...held.values()];
+            if (JSON.stringify(list) !== JSON.stringify(conversationList)) {
+                await local.fact('conversationList', list);
+            }
+            if (change.cursor !== undefined) {
+                if (change.cursor !== conversationCursor) {
+                    await local.fact('conversationCursor', change.cursor);
+                }
+                deps.stream()?.hold(change.cursor);
+            }
+            return list;
+        })
+            .catch(async () => (await (await deps.local()).facts()).conversationList ?? [])
+            .then((list) => {
+            if (deps.closed() || change.paged === true)
+                return;
+            endedAnew(list);
+            if (change.cursor !== undefined) {
+                listKnown = true;
+                settleBehind(list);
+                openingEnded();
+                deps.settled();
+            }
+            emitList();
+            if (!listKnown)
+                return;
+            retiredDrafts(list);
+            if (change.cursor === undefined &&
+                (list.length !== replicated.size ||
+                    list.some(({ conversation }) => !replicated.has(conversation)))) {
+                deps.again();
+            }
+        }, () => { });
+    }
+    function endedAnew(list) {
+        const entries = new Map(list.map((entry) => [entry.conversation, entry]));
+        for (const view of views.values()) {
+            const ended = entries.get(view.conversation)?.processEnded ?? null;
+            if (view.window === null || ended === view.ended)
+                continue;
+            view.ended = ended;
+            emit(view.conversation);
+        }
+    }
+    let listShown = Promise.resolve();
+    function shownList(work) {
+        const reading = heldList();
+        listShown = listShown.then(async () => {
+            const list = await reading.catch(() => null);
+            if (list === null || deps.closed())
+                return;
+            work(list);
+        });
+    }
     function emitList() {
-        if (deps.closed() || listWatchers.size === 0)
+        if (deps.closed())
             return;
-        const value = entries();
-        for (const watcher of listWatchers)
-            watcher(value);
+        if (listWatchers.size > 0) {
+            shownList((list) => {
+                const value = entries(list);
+                for (const watcher of listWatchers)
+                    watcher(value);
+            });
+        }
+        emitAgents();
+        learned();
+    }
+    function learned() {
+        if (deps.closed() || (unlisted.size === 0 && unnamed.size === 0))
+            return;
+        shownList((list) => {
+            if (unlisted.size > 0) {
+                const value = entries(list);
+                for (const watcher of [...unlisted]) {
+                    unlisted.delete(watcher);
+                    listWatchers.add(watcher);
+                    watcher(value);
+                }
+            }
+            if (unnamed.size > 0) {
+                const value = agents(list);
+                for (const watcher of [...unnamed]) {
+                    unnamed.delete(watcher);
+                    agentWatchers.add(watcher);
+                    watcher(value);
+                }
+            }
+        });
     }
-    function agents() {
-        return [...agentNames]
-            .filter(([identity]) => !retiredAgents.has(identity))
-            .map(([identity, name]) => ({ identity, name }))
+    function agents(list) {
+        const named = new Map();
+        for (const agent of listedAgents ?? [])
+            named.set(agent.agent, agent);
+        for (const entry of list) {
+            named.set(entry.agent, { name: entry.agentName, retired: entry.agentRetired });
+        }
+        return [...named]
+            .filter(([, agent]) => !agent.retired)
+            .map(([identity, agent]) => ({ identity, name: agent.name }))
             .sort((left, right) => left.name === right.name
             ? left.identity.localeCompare(right.identity)
             : left.name.localeCompare(right.name));
     }
+    function readAgents() {
+        const stream = deps.stream();
+        if (stream?.agents === undefined || !deps.online() || agentsReading)
+            return;
+        agentsReading = true;
+        void stream
+            .agents()
+            .then((read) => {
+            if (read === null)
+                return;
+            listedAgents = read;
+            emitAgents();
+        }, () => { })
+            .finally(() => {
+            agentsReading = false;
+        });
+    }
     function emitAgents() {
         if (deps.closed() || agentWatchers.size === 0)
             return;
-        const value = agents();
-        for (const watcher of agentWatchers)
-            watcher(value);
+        shownList((list) => {
+            const value = agents(list);
+            const shown = JSON.stringify(value);
+            if (shown === agentsShown)
+                return;
+            agentsShown = shown;
+            for (const watcher of agentWatchers)
+                watcher(value);
+        });
     }
     function setLive(conversation, next) {
         const before = stateOf(conversation);
@@ -380,60 +521,14 @@ export function createConversationStore(deps) {
             lives.delete(conversation);
         else
             lives.set(conversation, next);
-        if (!listing.has(conversation))
-            return;
         if (stateOf(conversation) !== before || next?.turn?.started !== began)
             emitList();
     }
-    async function readAgents() {
-        const declaration = deps.agents();
-        if (declaration === undefined)
-            return;
-        const names = new Map();
-        const retired = new Set();
-        let covered = null;
-        for (let after;;) {
-            const read = await deps.documents(declaration, after);
-            if ('pending' in read)
-                return;
-            const coverage = JSON.stringify(read.coverage);
-            if (covered !== null && coverage !== covered)
-                return readAgents();
-            covered = coverage;
-            for (const document of read.documents) {
-                const identity = document.fields?.[declaration.identity];
-                const name = document.fields?.[declaration.name];
-                if (typeof identity !== 'string' || typeof name !== 'string')
-                    continue;
-                names.set(identity, name);
-                const ended = declaration.retired === undefined ? null : document.fields?.[declaration.retired];
-                if (ended !== undefined && ended !== null)
-                    retired.add(identity);
-            }
-            if (read.next === undefined)
-                break;
-            after = read.next;
-        }
-        const named = JSON.stringify([...names]) !== JSON.stringify([...agentNames]);
-        if (!named && JSON.stringify([...retired]) === JSON.stringify([...retiredAgents]))
-            return;
-        agentNames = names;
-        retiredAgents = retired;
-        if (named)
-            emitList();
-        emitAgents();
-        const ended = [...drafts.keys()].filter(retiredChat);
-        if (ended.length > 0)
-            await remove(ended);
-    }
-    function retiredChat(conversation) {
-        return (conversation.startsWith(NEW_CHAT) && retiredAgents.has(conversation.slice(NEW_CHAT.length)));
-    }
-    function agentsReady() {
-        agentsRead ??= readAgents().catch(() => {
-            agentsRead = null;
-        });
-        return agentsRead;
+    function retiredChat(conversation, list) {
+        if (!conversation.startsWith(NEW_CHAT))
+            return false;
+        const agent = conversation.slice(NEW_CHAT.length);
+        return list.some((entry) => entry.agent === agent && entry.agentRetired);
     }
     function live(conversation, change) {
         const owed = unsent.get(conversation);
@@ -456,6 +551,7 @@ export function createConversationStore(deps) {
                 commands: facts.has('commands') ? QUIET.commands : held.commands,
                 options: facts.has('options') ? QUIET.options : held.options,
                 starting: facts.has('starting') ? QUIET.starting : held.starting,
+                subagents: facts.has('subagents') ? QUIET.subagents : held.subagents,
                 link: facts.has('link') ? QUIET.link : held.link,
                 deliveryUnknown: facts.has('deliveryUnknown')
                     ? QUIET.deliveryUnknown
@@ -490,17 +586,23 @@ export function createConversationStore(deps) {
     }
     async function remove(leaving) {
         await deps.durably(async (local) => {
+            const kept = new Set([
+                ...(await local.conversations(leaving)).map(({ conversation }) => conversation),
+                ...(await local.chatDrafts())
+                    .filter(({ conversation }) => leaving.includes(conversation))
+                    .map(({ conversation }) => conversation),
+            ]);
             await local.dropConversations(leaving);
             const changed = [];
             for (const conversation of leaving) {
-                if (stored.has(conversation) || drafts.has(conversation) || lives.has(conversation)) {
+                if (kept.has(conversation) || lives.has(conversation))
                     changed.push(conversation);
+                for (const view of views.values()) {
+                    if (view.conversation === conversation)
+                        view.draft = null;
                 }
-                stored.delete(conversation);
-                reads.delete(conversation);
-                partials.delete(conversation);
-                drafts.delete(conversation);
                 behind.delete(conversation);
+                heardNewest.delete(conversation);
                 unsent.delete(conversation);
                 setLive(conversation, null);
                 await slide(local, conversation, null);
@@ -509,6 +611,69 @@ export function createConversationStore(deps) {
                 deps.publish(conversationChangeSet(changed));
         });
     }
+    function newestOfListed(entry) {
+        if (entry === undefined)
+            return undefined;
+        const heard = heardNewest.get(entry.conversation);
+        if (heard === undefined)
+            return entry.newest;
+        return entry.newest === null || heard > entry.newest ? heard : entry.newest;
+    }
+    function missed(conversation, held, entry) {
+        const read = held?.read;
+        const newest = newestOfListed(entry);
+        return (read === undefined ||
+            newest === undefined ||
+            held?.partial === true ||
+            (newest !== null && (read === null || newest > read)));
+    }
+    async function readsOf(local, conversations) {
+        return new Map((await local.conversations(conversations)).map((held) => [held.conversation, held]));
+    }
+    function retiredDrafts(list) {
+        if (!list.some((entry) => entry.agentRetired))
+            return;
+        void deps
+            .local()
+            .then((local) => local.chatDrafts())
+            .then((held) => {
+            if (!deps.closed() && held.some(({ conversation }) => retiredChat(conversation, list))) {
+                deps.again();
+            }
+        }, () => { });
+    }
+    function settleBehind(list) {
+        void deps
+            .durably(async (local) => {
+            const entries = new Map(list.map((entry) => [entry.conversation, entry]));
+            const named = [...replicated].filter((conversation) => entries.has(conversation));
+            const held = await readsOf(local, named);
+            let owed = false;
+            for (const conversation of named) {
+                if (!missed(conversation, held.get(conversation), entries.get(conversation))) {
+                    behind.delete(conversation);
+                }
+                else if (!behind.has(conversation)) {
+                    gap(conversation);
+                    owed = true;
+                }
+            }
+            return owed;
+        })
+            .then((owed) => {
+            if (deps.closed())
+                return;
+            deps.settled();
+            if (owed)
+                deps.again();
+        }, () => { });
+    }
+    function noted(conversation, message) {
+        const heard = heardNewest.get(conversation);
+        if (heard === undefined || message.position > heard) {
+            heardNewest.set(conversation, message.position);
+        }
+    }
     function gap(conversation) {
         gaps.set(conversation, (gaps.get(conversation) ?? 0) + 1);
         behind.add(conversation);
@@ -517,7 +682,7 @@ export function createConversationStore(deps) {
         return deps.durably(async (local) => {
             if (!replicated.has(conversation))
                 return;
-            const read = reads.get(conversation);
+            const read = (await readsOf(local, [conversation])).get(conversation)?.read;
             const advances = read !== undefined &&
                 !behind.has(conversation) &&
                 (read === null || message.position > read);
@@ -527,9 +692,6 @@ export function createConversationStore(deps) {
                 messages: [message],
                 ...(advances ? { read: { at: message.position, partial: false } } : {}),
             });
-            stored.add(conversation);
-            if (advances)
-                reads.set(conversation, message.position);
             sealTurns(conversation, new Set([message.turn]));
             await slide(local, conversation, [message]);
             deps.publish(conversationChangeSet([conversation]));
@@ -537,13 +699,14 @@ export function createConversationStore(deps) {
     }
     async function readHistories(conversations, ended) {
         const generations = new Map(conversations.map((one) => [one, gaps.get(one) ?? 0]));
+        const held = await readsOf(await deps.local(), conversations);
         let waiting = conversations.map((conversation) => ({
             conversation,
-            after: reads.get(conversation) ?? undefined,
+            after: held.get(conversation)?.read ?? undefined,
         }));
         while (waiting.length > 0) {
             const asking = waiting.slice(0, HISTORY_CONVERSATIONS);
-            const result = await deps.call('conversation.history', {
+            const result = await deps.history({
                 conversations: asking.map(({ conversation, after }) => ({
                     conversation,
                     ...(after === undefined ? {} : { after }),
@@ -595,15 +758,10 @@ export function createConversationStore(deps) {
                 return;
             const whole = next === undefined;
             const cursor = next ?? newestOf(arriving, from);
-            const partial = !whole && (partials.has(conversation) || !reads.has(conversation));
+            const held = (await readsOf(local, [conversation])).get(conversation);
+            const partial = !whole && (held?.partial === true || held?.read === undefined);
             const sealing = await sealed(local, conversation, new Set(arriving.map((message) => message.turn)));
             await local.keepMessages({ conversation, messages: arriving, read: { at: cursor, partial } });
-            stored.add(conversation);
-            reads.set(conversation, cursor);
-            if (partial)
-                partials.add(conversation);
-            else
-                partials.delete(conversation);
             sealTurns(conversation, new Set(arriving.map((message) => message.turn)));
             if (whole && (gaps.get(conversation) ?? 0) === generation)
                 behind.delete(conversation);
@@ -646,6 +804,10 @@ export function createConversationStore(deps) {
             live(conversation, { starting: event.step });
             return;
         }
+        if (event.kind === 'subagents') {
+            live(conversation, { subagents: structuredClone(event.subagents) });
+            return;
+        }
         if (event.kind === 'link') {
             live(conversation, { link: { connected: event.connected } });
             return;
@@ -657,6 +819,7 @@ export function createConversationStore(deps) {
         const arriving = acceptedMessage(event.message);
         if (arriving === null)
             return;
+        noted(conversation, arriving);
         if (replicated.has(conversation)) {
             if (deps.full()) {
                 gap(conversation);
@@ -672,17 +835,24 @@ export function createConversationStore(deps) {
             emit(conversation);
     }
     async function kept(local, conversation, following) {
-        if (following === null || empty(following)) {
+        const shown = following === null || empty(following) ? null : following;
+        if (shown === null)
             await local.dropChatDraft(conversation);
-            drafts.delete(conversation);
-        }
-        else {
-            await local.keepChatDrafts([following]);
-            drafts.set(conversation, following);
+        else
+            await local.keepChatDrafts([shown]);
+        shownDraft(conversation, shown);
+    }
+    function shownDraft(conversation, draft) {
+        for (const view of views.values()) {
+            if (view.conversation === conversation)
+                view.draft = draft;
         }
     }
+    async function draftAt(local, conversation) {
+        return (await local.chatDraft(conversation)) ?? undefined;
+    }
     async function sealed(local, conversation, turns) {
-        const held = drafts.get(conversation);
+        const held = await draftAt(local, conversation);
         const submitted = held?.submitted ?? [];
         const left = submitted.filter((one) => one.turn === null || !turns.has(one.turn));
         if (held === undefined || left.length === submitted.length)
@@ -693,8 +863,8 @@ export function createConversationStore(deps) {
     function moved(agent, operation, to) {
         const from = newChat(agent);
         return deps.durably(async (local) => {
-            const held = drafts.get(from);
-            const earlier = (held?.moves ?? []).filter((one) => !deps.expired(one));
+            const held = await draftAt(local, from);
+            const earlier = held?.moves ?? [];
             if (earlier.includes(operation))
                 return;
             const blank = {
@@ -703,18 +873,20 @@ export function createConversationStore(deps) {
                 revision: chatDraftRevision(),
             };
             const { moves: _answered, ...unsent } = held ?? blank;
-            const taken = drafts.has(to) || empty(unsent) ? [] : [{ ...unsent, conversation: to }];
+            const taken = (await draftAt(local, to)) !== undefined || empty(unsent)
+                ? []
+                : [{ ...unsent, conversation: to }];
             const left = { ...(taken.length === 0 ? unsent : blank), moves: [...earlier, operation] };
             await local.keepChatDrafts([left, ...taken]);
-            drafts.set(from, left);
+            shownDraft(from, left);
             for (const one of taken)
-                drafts.set(to, one);
+                shownDraft(to, one);
             deps.publish(conversationChangeSet([from, to]));
         });
     }
     function withDraft(conversation, next) {
         return deps.durably(async (local) => {
-            const following = await next(drafts.get(conversation), local);
+            const following = await next(await draftAt(local, conversation), local);
             if (following === undefined)
                 return;
             await kept(local, conversation, following);
@@ -723,10 +895,8 @@ export function createConversationStore(deps) {
     }
     async function submitted(conversation, operation, draft) {
         let submission;
-        let earlier = false;
         await withDraft(conversation, (current) => {
             submission = current?.submitted?.find((one) => one.operation === operation);
-            earlier = submission !== undefined;
             if (submission !== undefined)
                 return undefined;
             const said = draft ?? current;
@@ -739,23 +909,15 @@ export function createConversationStore(deps) {
                 submitted: [...(current?.submitted ?? []), submission],
             };
         });
-        return { submission: submission, earlier };
-    }
-    function forgotten(conversation, submission) {
-        return withDraft(conversation, (current) => {
-            const held = current?.submitted ?? [];
-            if (current === undefined || !held.includes(submission))
-                return undefined;
-            return withSubmitted(current, held.filter((one) => one !== submission));
-        });
+        return submission;
     }
     async function dispatched(conversation, submission) {
         const dispatch = { answered: false };
         sending.set(submission.operation, dispatch);
         try {
-            const result = await invoke('conversation.send', conversation, {
-                text: submission.text,
+            const result = await invoke('conversations/send', conversation, {
                 operation_id: submission.operation,
+                text: submission.text,
             });
             dispatch.answered = result.kind !== 'transport-uncertainty';
             if (result.kind === 'revoked-authorization')
@@ -764,7 +926,7 @@ export function createConversationStore(deps) {
                 deps.unanswered();
                 return result;
             }
-            const turn = answered(result, 'turn');
+            const turn = answered(result, 'message_id');
             await withDraft(conversation, async (current, local) => {
                 const held = current?.submitted?.find((one) => one.operation === submission.operation);
                 if (current === undefined || held === undefined || held.turn !== null)
@@ -784,29 +946,40 @@ export function createConversationStore(deps) {
                 sending.delete(submission.operation);
         }
     }
-    function invoke(name, conversation, extra = {}) {
-        return deps.call(name, { conversation, ...extra });
+    function invoke(name, conversation, extra = { operation_id: changeBatchIdentity() }) {
+        return deps.call(name, { conversation_id: conversation, ...extra });
     }
     const surface = {
-        async list() {
-            await agentsReady();
-            return entries();
+        list() {
+            return new Promise((settle) => {
+                const answer = (listed) => {
+                    unlisted.delete(answer);
+                    listWatchers.delete(answer);
+                    settle(listed);
+                };
+                unlisted.add(answer);
+                learned();
+            });
         },
         async read(conversation, options = {}) {
-            const asked = askedOf(options);
+            const { text, ...windowed } = options;
+            const asked = askedOf(windowed);
+            const phrase = phraseOf(text);
             return deps.durably(async (local) => {
-                const { messages, more } = await local.messageWindow(conversation, asked.limit, asked.before);
-                const total = asked.total ? await local.messageCount(conversation) : null;
-                return structuredClone(viewOf(conversation, messages, frameOf(asked, messages, more, total)));
+                const { messages, more } = await local.messageWindow(conversation, asked.limit, asked.before, phrase);
+                const total = asked.total ? await local.messageCount(conversation, phrase) : null;
+                return structuredClone(viewOf(conversation, messages, frameOf(asked, messages, more, total), (await local.chatDraft(conversation)) ?? null, await endedIn(conversation)));
             });
         },
         async create(input) {
-            const result = await deps.call('conversation.create', input);
-            const conversation = answered(result, 'conversation');
+            const result = await deps.call('conversations/create', input);
+            const conversation = answered(result, 'conversation_id');
             if (conversation === null)
                 return result;
-            if (!listing.has(conversation))
+            const listed = (await heldList()) ?? [];
+            if (!listed.some((entry) => entry.conversation === conversation)) {
                 creations.add(conversation);
+            }
             const creation = creationOf(input);
             if (creation !== null)
                 await moved(creation.agent, creation.operation, conversation);
@@ -823,11 +996,7 @@ export function createConversationStore(deps) {
                 });
                 if (held === null)
                     return DURABLE_WRITE;
-                const { submission, earlier } = held;
-                if (!earlier || !deps.expired(operation))
-                    return dispatched(conversation, submission);
-                await forgotten(conversation, submission);
-                return EXPIRED;
+                return dispatched(conversation, held);
             }
             if (draft !== undefined) {
                 await withDraft(conversation, (current) => current?.submitted?.some((one) => one.operation === operation) === true
@@ -836,38 +1005,20 @@ export function createConversationStore(deps) {
             }
             return OFFLINE;
         },
-        async attach(room, file) {
-            if (!deps.online())
-                return OFFLINE;
-            return deps.call('conversation.attach', {
-                room,
-                ...(await declaredFile(file)),
-                blob: file.blob,
-            });
-        },
         answer(conversation, answer) {
-            return invoke('conversation.answer', conversation, { answer });
+            return invoke('conversations/interaction/answer', conversation, {
+                operation_id: changeBatchIdentity(),
+                ...answer,
+            });
         },
         interrupt(conversation) {
-            return invoke('conversation.interrupt', conversation);
+            return invoke('conversations/interrupt', conversation);
         },
         kill(conversation) {
-            return invoke('conversation.kill', conversation);
-        },
-        async cancel(conversation, turn) {
-            const result = await invoke('conversation.cancel', conversation, { turn });
-            if (result.kind !== 'action')
-                return result;
-            await withDraft(conversation, (current) => {
-                const held = current?.submitted?.find((one) => one.turn === turn);
-                if (current === undefined || held === undefined)
-                    return undefined;
-                return returned(current, held, current.submitted.filter((one) => one !== held));
-            });
-            return result;
+            return invoke('conversations/kill', conversation);
         },
         delete(conversation) {
-            return invoke('conversation.delete', conversation);
+            return invoke('conversations/delete', conversation);
         },
     };
     const chatDraft = {
@@ -896,33 +1047,40 @@ export function createConversationStore(deps) {
     return {
         surface,
         chatDraft,
-        hydrate(held, kept) {
-            stored.clear();
-            reads.clear();
-            partials.clear();
-            for (const entry of held) {
-                stored.add(entry.conversation);
-                if (entry.read !== undefined)
-                    reads.set(entry.conversation, entry.read);
-                if (entry.partial)
-                    partials.add(entry.conversation);
-            }
-            drafts.clear();
-            for (const record of kept)
-                drafts.set(record.conversation, record);
+        async opened(local) {
+            const { conversationList, conversationCursor } = await local.facts();
+            if (conversationList === null || listKnown)
+                return;
+            deps.stream()?.hold(conversationCursor);
+            learned();
         },
         async reconcile() {
             if (!listKnown)
                 return;
-            const named = new Set(listing.keys());
+            const local = await deps.local();
+            const [held, kept, { conversationList }] = await Promise.all([
+                local.conversations(),
+                local.chatDrafts(),
+                local.facts(),
+            ]);
+            const list = conversationList ?? [];
+            const entries = new Map(list.map((entry) => [entry.conversation, entry]));
+            const named = new Set(entries.keys());
+            const reads = new Map(held.map((one) => [one.conversation, one]));
             const leaving = [
-                ...new Set([...replicated, ...stored, ...reads.keys(), ...drafts.keys()]),
+                ...new Set([
+                    ...replicated,
+                    ...reads.keys(),
+                    ...kept.map(({ conversation }) => conversation),
+                ]),
             ].filter((conversation) => !named.has(conversation) &&
                 !creations.has(conversation) &&
-                (!conversation.startsWith(NEW_CHAT) || retiredChat(conversation)));
+                (!conversation.startsWith(NEW_CHAT) || retiredChat(conversation, list)));
             for (const conversation of named) {
-                if (!replicated.has(conversation))
+                if (!replicated.has(conversation) &&
+                    missed(conversation, reads.get(conversation), entries.get(conversation))) {
                     behind.add(conversation);
+                }
             }
             replicated = named;
             handReplicated();
@@ -953,16 +1111,16 @@ export function createConversationStore(deps) {
                 progress.complete = false;
         },
         async resend(progress) {
-            for (const [conversation, held] of [...drafts]) {
-                for (const submission of held.submitted ?? []) {
-                    if (submission.turn !== null || sending.has(submission.operation))
-                        continue;
+            const local = await deps.local();
+            const tried = new Set();
+            for (const { conversation } of await local.chatDrafts()) {
+                for (;;) {
+                    const submission = (await local.chatDraft(conversation))?.submitted?.find((one) => one.turn === null && !sending.has(one.operation) && !tried.has(one.operation));
+                    if (submission === undefined)
+                        break;
                     if (deps.closed())
                         return;
-                    if (deps.expired(submission.operation)) {
-                        await forgotten(conversation, submission);
-                        continue;
-                    }
+                    tried.add(submission.operation);
                     const result = await dispatched(conversation, submission);
                     if (result.kind === 'revoked-authorization')
                         return;
@@ -983,11 +1141,8 @@ export function createConversationStore(deps) {
         known() {
             return listKnown;
         },
-        reconnected() {
-            for (const conversation of replicated)
-                gap(conversation);
-        },
         reopened() {
+            relisting = null;
             for (const [operation, dispatch] of sending)
                 if (!dispatch.answered)
                     sending.delete(operation);
@@ -1003,30 +1158,35 @@ export function createConversationStore(deps) {
                 asked,
                 watchers: new Set(),
                 window: null,
+                draft: null,
+                ended: null,
                 more: false,
                 total: null,
             };
             views.set(key, view);
             const watcher = { notify: deliver, ready: false };
             view.watchers.add(watcher);
-            void deps
-                .durably(async (local) => {
+            const reading = new AbortController();
+            void untilAnswered(() => deps.durably(async (local) => {
                 if (view.window !== null)
                     return;
                 const { messages, more } = await local.messageWindow(conversation, asked.limit, asked.before);
+                view.draft = (await local.chatDraft(conversation)) ?? null;
+                view.ended = await endedIn(conversation);
                 view.window = messages;
                 view.more = more;
                 view.total = asked.total ? await local.messageCount(conversation) : null;
-            })
+            }), reading.signal)
                 .then(() => {
                 if (deps.closed() || !view.watchers.has(watcher))
                     return;
                 watcher.ready = true;
                 const window = view.window ?? [];
-                watcher.notify(viewOf(conversation, window, sharedFrame(view, window)));
+                watcher.notify(viewOf(conversation, window, sharedFrame(view, window), view.draft, view.ended));
             })
                 .catch(() => { });
             return () => {
+                reading.abort();
                 if (!view.watchers.delete(watcher))
                     return;
                 if (view.watchers.size === 0)
@@ -1034,77 +1194,69 @@ export function createConversationStore(deps) {
             };
         },
         watchList(deliver) {
-            listWatchers.add(deliver);
-            void agentsReady().then(() => {
-                if (!deps.closed() && listWatchers.has(deliver))
-                    deliver(entries());
-            });
+            unlisted.add(deliver);
+            learned();
             return () => {
+                unlisted.delete(deliver);
                 listWatchers.delete(deliver);
             };
         },
         watchAgents(deliver) {
-            agentWatchers.add(deliver);
-            void agentsReady().then(() => {
-                if (!deps.closed() && agentWatchers.has(deliver))
-                    deliver(agents());
-            });
+            unnamed.add(deliver);
+            learned();
+            readAgents();
             return () => {
+                unnamed.delete(deliver);
                 agentWatchers.delete(deliver);
             };
         },
+        learned,
         changed(set) {
             for (const conversation of set.conversations)
                 emit(conversation);
-            const declaration = deps.agents();
-            if (declaration !== undefined &&
-                set.documents.some((change) => change.locator === declaration.locator)) {
-                agentsRead = readAgents().catch(() => {
-                    agentsRead = null;
-                });
-            }
         },
         receive(event) {
             if (deps.closed())
-                return false;
-            if (event.kind === 'list' || event.kind === 'listed' || event.kind === 'unlisted') {
-                if (event.kind === 'list') {
-                    listing.clear();
-                    for (const entry of event.entries) {
-                        listing.set(entry.conversation, { ...entry });
-                        creations.delete(entry.conversation);
-                    }
-                    listKnown = true;
-                    openingEnded();
-                }
-                else if (event.kind === 'listed') {
-                    listing.set(event.entry.conversation, { ...event.entry });
-                    creations.delete(event.entry.conversation);
-                }
-                else {
-                    listing.delete(event.conversation);
+                return;
+            if (event.kind === 'list') {
+                if (event.whole)
+                    relisting ??= new Map();
+                if (relisting !== null) {
+                    for (const entry of event.entries)
+                        relisting.set(entry.conversation, { ...entry });
                 }
-                emitList();
-                return (event.kind !== 'list' &&
-                    listKnown &&
-                    (listing.size !== replicated.size ||
-                        [...listing.keys()].some((conversation) => !replicated.has(conversation))));
+                if (event.more && relisting !== null)
+                    return;
+                const whole = relisting;
+                relisting = null;
+                listChanged({
+                    replacing: whole !== null,
+                    set: whole === null ? event.entries : [...whole.values()],
+                    gone: null,
+                    ...(event.more ? { paged: true } : { cursor: event.cursor }),
+                });
+                return;
+            }
+            if (event.kind === 'listed') {
+                relisting?.set(event.entry.conversation, { ...event.entry });
+                listChanged({ replacing: false, set: [event.entry], gone: null });
+                return;
+            }
+            if (event.kind === 'unlisted') {
+                relisting?.delete(event.conversation);
+                listChanged({ replacing: false, set: [], gone: event.conversation });
+                return;
             }
             heard(event);
-            return false;
-        },
-        searchable() {
-            return [...(listKnown ? listing.keys() : stored)].sort();
-        },
-        acquired(conversation) {
-            return reads.has(conversation) && !partials.has(conversation);
         },
         close() {
             views.clear();
             lives.clear();
             unsent.clear();
             listWatchers.clear();
+            unlisted.clear();
             agentWatchers.clear();
+            unnamed.clear();
         },
     };
 }