@agentshouse/mdruntime-adapter 0.1.0-alpha.2 → 0.1.0-alpha.20

package/AGENTS.md

@@ -7,36 +7,126 @@ enforcement.
 ## The MD Runtime API
 
 App code reaches the MD Runtime through the remote client. The surfaces are
-Rooms, Query, Observe, Types, Draft, Save, Queue, History, Call, Log,
-storage loss, the reported persistence answer, Sync Status, reauthorization,
-conversation, the unsent instruction, and Presentation State.
-
-Rooms, Query, Observe, Types, Draft, and Save never touch the network.
+Rooms, Slots, Query, Search, Observe, Types, Room Draft, Save, History, Call, Log,
+storage loss, the reported persistence answer, deployment facts, Sync Status, reauthorization,
+conversation, the chat draft, and Presentation State.
+
+Each conversation a Provider card names is held complete in the browser.
+Observe one with `observe('conversation', id, { limit }, listener)`: the view
+holds its latest `limit` messages, or all of them, oldest first, with the
+growing text and the session summary while it is viewed, and its chat draft.
+`chatDraft.write` and `chatDraft.discard` keep what the App Creator composes;
+sending it is a Provider Action that needs the Provider reachable and is never
+queued.
+
+Slots answers each Slot the Provider declares, in its order, with its entries
+in order, each a Room and its segment; a Room two Slots list is the same Room.
+
+Rooms, Slots, Query, Search, Observe, Types, Room Draft, and Save never touch the
+network.
 History and Call go to the Provider through the Adapter. Every member of the
 client is asynchronous. Results are detached snapshots. Nothing in this
 surface returns the authorization, performs a request the App's code
 composes, or exposes the browser store.
 
+Read deployment facts with `deploymentFacts()` and observe replacements with
+`observe('deployment-facts', listener)`. Interpret the opaque value using the
+host's contract. [R038](https://github.com/agentshouse/mdruntime/blob/main/docs/requirements/ledger.md#r038--runtime-host-and-remote-client)
+owns their boundary.
+
 The in-memory Adapter at `@agentshouse/mdruntime/memory` is for tests and
 ships in no bundle.
 
-## Draft, Save, and outcome rules
-
-A Draft is durable: it survives reload and navigation. Save takes structured
-changes, validates locally, and on success appends one Change Batch to that
-Room's queue. A local validation failure leaves the Draft and creates
-nothing.
+## Local Query rules
+
+`query(q)` answers once from local state; `observe('query', q, listener)` hears
+the whole result at once and again only when it changes. A query is data:
+
+- **Filter.** `rooms` names Room locators and defaults to every Room. `types`
+  names MD Types, and `any` names the untyped Documents. `pathPrefix` is a
+  directory: `notes` keeps `notes/a.md` and not `notes2/a.md`.
+- **Fields.** `where` names frontmatter fields, ANDs them, and nests `$and` and
+  `$or`. A bare value is equality; the operators are `$eq`, `$ne`, `$in`, `$nin`,
+  `$gt`, `$gte`, `$lt`, `$lte`, `$all`, `$size` and `$exists`. Equality on a list
+  asks whether it contains the value. Missing, null and empty differ:
+  `$exists: false` keeps a missing field, `null` an explicit null, `''` empty
+  text and `$size: 0` an empty list. A date compares in calendar order and never
+  with a date-time. A reference compares by the Room Path it resolves to.
+  Untyped frontmatter is plain values. There is no text containment or regular
+  expression.
+- **Relations.** `hop: { field, types, where, pathPrefix }` keeps Documents whose
+  reference `field` points to a matching Document of the same Room.
+  `backlinks: { field, types, where, pathPrefix }` keeps Documents that a
+  matching Document of the same Room references. Each keeps a Document once.
+- **Parts.** A Document query must `select`: `'all'`, or `fields`, `sections`,
+  `preamble`, `markdown` and `backlinks`, where `fields` and `sections` are
+  `'all'` or a list of names. Room, Path and MD Type always return, and an
+  unselected part is absent. Select only what a screen shows: a list that selects
+  the Markdown hears every edit of it.
+- **Order and groups.** `orderBy` sorts by `room`, `path`, `type` or `{ field }`
+  with TanStack DB's own options, and ties end with Room, then Path. `groupBy` by
+  `room`, `type` or `{ field }` answers `{ groups: [{ key, count }] }`, counted
+  over every match and ordered by `count` or a key. `limit` bounds the Documents
+  or the groups.
+- **Results and errors.** A result carries no Room Version: read freshness from
+  Rooms and Sync Status. An invalid query fails with `invalid-query`,
+  `unknown-type`, `unknown-field` or `wrong-kind`, naming where, and never
+  answers an empty result in its place.
+
+## Local Search rules
+
+`search({ text, documents, conversations, limit })` answers once, by words, from
+local state, with MiniSearch at its default configuration. There is no observed
+search.
+
+- **What is found.** A Document by its field values, its sections' headings and
+  text, its preamble and its Path; a message by its text. Frontmatter keys, Room
+  Drafts, chat drafts and growing text are never found. There are no phrases,
+  word forms, typo tolerance or prefix matching.
+- **Narrowing.** `documents` is a Local Query filter: `rooms`, `types`, `where`,
+  `pathPrefix`, `hop` and `backlinks`. `conversations` names conversations. Both
+  apply before `limit`, which bounds each list; without it every hit returns.
+- **Results.** `{ documents, messages }`, each ranked by `score`, which compares
+  hits of one list of one search. A Document hit names its `room`, `path` and
+  `type`, a message hit its `conversation` and `identity`, and `matches` maps each
+  matched word to the parts it matched in: `fields`, `sections`, `preamble` or
+  `path`, or `text`. A hit carries no position; mark the words in the text you
+  show. An invalid filter fails with its Local Query error.
+
+## Room Draft, Save, and outcome rules
+
+The MD Runtime owns one Room Draft per Room and Path, shared by every App and
+tab. It is durable: it survives reload and navigation. A Room that Discovery
+stops listing takes its Room Drafts, its queue and their outcomes with it.
+Write a Room Draft with `roomDraft.write(room, path, revision, parts)`, naming
+the revision you read, or `null` when there was none, and every part it should
+now change: fields, sections and the preamble, or the whole Markdown, a
+creation, a move, or a removal. A part new to the Room Draft names its base,
+the value you showed when it was opened; the MD Runtime keeps a part's first
+base. A write or a discard from an older revision is refused as `stale` with
+the current Room Draft; read it and write again.
+
+Save takes one Room and the Room Drafts of it to save, each with its revision,
+validates locally, and on success appends one Change Batch to that Room's
+queue and removes those Room Drafts. It is refused as `stale`, as
+`changed-underneath` naming each part whose base no longer matches the visible
+state, or by a local validation rule, and then creates nothing and leaves every
+Room Draft in place. A directory move is a move part on each Document beneath
+it, saved together.
 
 Outcomes follow the Provider's answer. Accepted advances the confirmed
-layer. Conflicted and Rejected leave the head in place, carry the affected
-current state and the Provider's structured refusal code and fields as
-returned, and block that Room's queue. The App's code resolves a head by
-discarding it or by saving a corrected Change Batch that replaces it in
-place. Transport failure and Provider unavailability keep work Pending and
-do not infer a rejection. A refusal the Provider marks retryable stays
-Pending until the reset it names; the MD Runtime retries the same Change
-Batch identity and payload and never infers an outcome from transport
-uncertainty. The MD Runtime never combines, reorders, or rebases.
+layer. Conflicted and Rejected, an expired outcome record, and a change that no
+longer applies over the Room each leave the queue and return as Room Drafts on
+the Documents they changed, marked with why: the Provider's structured refusal
+code and fields as returned, not known to have applied, or withdrawn locally.
+The rest of the queue keeps synchronizing, and Sync Status requires attention
+until each returned Room Draft is saved again or discarded. `outcome` answers
+the saved Change Batch's outcome, and `null` while it is Pending. Transport
+failure and Provider unavailability keep work Pending and do not infer a
+rejection. A refusal the Provider marks retryable stays Pending until the reset
+it names; the MD Runtime retries the same Change Batch identity and payload and
+never infers an outcome from transport uncertainty. The MD Runtime never
+combines, reorders, or rebases.
 
 ## The neutrality rule
 
@@ -61,8 +151,8 @@ a desktop. Its strings are English only, dates and numbers follow the
 browser locale, and content is never translated. Light and dark themes come
 from CSS custom properties with the browser's preference as the default and
 an App's override respected. What an App Creator's agent adds carries none
-of these promises by itself. Reading and querying never wait for the
-network. Data lives only in the App Creator's browser and with the Provider.
+of these promises by itself. Reading, querying and searching never wait for
+the network. Data lives only in the App Creator's browser and with the Provider.
 
 ## App code imports only the client entry and never constructs a Runtime
 

package/dist/actions.d.ts

@@ -1,16 +1,8 @@
-import { type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationCards } from '@agentshouse/mdruntime';
+import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationCards } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
-export declare const CONVERSATION_ACTIONS: readonly ['conversation.create', 'conversation.send', 'conversation.answer', 'conversation.interrupt', 'conversation.kill', 'conversation.cancel', 'conversation.delete', 'conversation.history'];
-export declare const HOUSE_ACTS: readonly ['conversations/interaction/read', 'conversations/originals/read', 'apps/read', 'apps/customize', 'rooms/read', 'rooms/access/read', 'rooms/access/invitations', 'rooms/access/entries', 'rooms/access/invite', 'rooms/access/invitation-cancel', 'rooms/access/revoke', 'rooms/access/leave', 'rooms/roles/define', 'rooms/roles/remove', 'rooms/roles/assign', 'rooms/roles/unassign', 'rooms/settings/processing/read', 'rooms/settings/processing/write', 'profiles/create', 'profiles/read', 'profiles/edit', 'profiles/duplicate', 'profiles/delegate', 'agents/create', 'agents/read', 'routines/requests', 'routines/access', 'routines/owned', 'routines/granted', 'routines/grant', 'routines/send', 'routines/cancel', 'routines/start', 'routines/schedules', 'routines/schedules/create', 'routines/schedules/enabled', 'account/security/read', 'storage/inventory', 'storage/usage', 'usage/statement', 'storage/blob-store', 'storage/blob-store/select', 'storage/connections', 'storage/archive', 'storage/archive/status', 'environments/read', 'environments/create', 'environments/start', 'environments/stop', 'environments/delete', 'environments/renewals/read', 'environments/work/read', 'nodes/read'];
-export declare const HOUSE_PROVIDER_ACTIONS: readonly ["conversation.create", "conversation.send", "conversation.answer", "conversation.interrupt", "conversation.kill", "conversation.cancel", "conversation.delete", "conversation.history", "conversations/interaction/read", "conversations/originals/read", "apps/read", "apps/customize", "rooms/read", "rooms/access/read", "rooms/access/invitations", "rooms/access/entries", "rooms/access/invite", "rooms/access/invitation-cancel", "rooms/access/revoke", "rooms/access/leave", "rooms/roles/define", "rooms/roles/remove", "rooms/roles/assign", "rooms/roles/unassign", "rooms/settings/processing/read", "rooms/settings/processing/write", "profiles/create", "profiles/read", "profiles/edit", "profiles/duplicate", "profiles/delegate", "agents/create", "agents/read", "routines/requests", "routines/access", "routines/owned", "routines/granted", "routines/grant", "routines/send", "routines/cancel", "routines/start", "routines/schedules", "routines/schedules/create", "routines/schedules/enabled", "account/security/read", "storage/inventory", "storage/usage", "usage/statement", "storage/blob-store", "storage/blob-store/select", "storage/connections", "storage/archive", "storage/archive/status", "environments/read", "environments/create", "environments/start", "environments/stop", "environments/delete", "environments/renewals/read", "environments/work/read", "nodes/read"];
-export declare const HISTORY_PAGE = 100;
 export declare const HOUSE_CONVERSATION_CARDS: ConversationCards;
-export declare function declaredActions(): readonly ActionDeclaration[];
+export declare function declaredActions(routes: readonly string[]): readonly ActionDeclaration[];
 export declare function houseAction(transport: HouseTransport, request: ActionRequest): Promise<ActionResult>;
 export declare function actionOutcome(answer: HouseDoorAnswer, name: string): ActionResult;
-export declare function readConversationHistory(transport: HouseTransport, conversationId: string): Promise<{
-    messages: unknown[];
-} | {
-    outcome: ActionResult;
-}>;
+export declare function acceptedMessage(entry: unknown): AcceptedMessage | null;
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,eAAO,MAAM,oBAAoB,YAC/B,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,CACd,CAAC;AAEX,eAAO,MAAM,UAAU,YACrB,gCAAgC,EAChC,8BAA8B,EAC9B,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,EAChC,iCAAiC,EACjC,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,YAAY,CACJ,CAAC;AAEX,eAAO,MAAM,sBAAsB,o2CAAoD,CAAC;AAIxF,eAAO,MAAM,YAAY,MAAM,CAAC;AAiBhC,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC;AAEF,wBAAgB,eAAe,IAAI,SAAS,iBAAiB,EAAE,CAM9D;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAWvB;AA4DD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CASjF;AA6ID,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CA4B9D"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiBtE,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CASvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAMvB;AAoED,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAWjF;AAuID,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUtE"}

package/dist/actions.js

@@ -1,121 +1,78 @@
-import { VERSION } from '@agentshouse/mdmodel';
 import { changeBatchIdentity } from '@agentshouse/mdruntime';
 import { doorRefusal } from './refusal.js';
-import { PRIVATE_AUTHORITY } from './transport.js';
-export const CONVERSATION_ACTIONS = [
-    'conversation.create',
-    'conversation.send',
-    'conversation.answer',
-    'conversation.interrupt',
-    'conversation.kill',
-    'conversation.cancel',
-    'conversation.delete',
-    'conversation.history'
-];
-export const HOUSE_ACTS = [
-    'conversations/interaction/read',
-    'conversations/originals/read',
-    'apps/read',
-    'apps/customize',
-    'rooms/read',
-    'rooms/access/read',
-    'rooms/access/invitations',
-    'rooms/access/entries',
-    'rooms/access/invite',
-    'rooms/access/invitation-cancel',
-    'rooms/access/revoke',
-    'rooms/access/leave',
-    'rooms/roles/define',
-    'rooms/roles/remove',
-    'rooms/roles/assign',
-    'rooms/roles/unassign',
-    'rooms/settings/processing/read',
-    'rooms/settings/processing/write',
-    'profiles/create',
-    'profiles/read',
-    'profiles/edit',
-    'profiles/duplicate',
-    'profiles/delegate',
-    'agents/create',
-    'agents/read',
-    'routines/requests',
-    'routines/access',
-    'routines/owned',
-    'routines/granted',
-    'routines/grant',
-    'routines/send',
-    'routines/cancel',
-    'routines/start',
-    'routines/schedules',
-    'routines/schedules/create',
-    'routines/schedules/enabled',
-    'account/security/read',
-    'storage/inventory',
-    'storage/usage',
-    'usage/statement',
-    'storage/blob-store',
-    'storage/blob-store/select',
-    'storage/connections',
-    'storage/archive',
-    'storage/archive/status',
-    'environments/read',
-    'environments/create',
-    'environments/start',
-    'environments/stop',
-    'environments/delete',
-    'environments/renewals/read',
-    'environments/work/read',
-    'nodes/read'
-];
-export const HOUSE_PROVIDER_ACTIONS = [
-    ...CONVERSATION_ACTIONS,
-    ...HOUSE_ACTS
-];
-const DECLARED = new Set(HOUSE_PROVIDER_ACTIONS);
-export const HISTORY_PAGE = 100;
+import { PRIVATE_LOCATOR } from './transport.js';
+const HISTORY_PAGE = 100;
 const OCTET_STREAM = 'application/octet-stream';
-const CONVERSATION_ROUTES = {
-    'conversation.create': '/door/conversations/create',
-    'conversation.send': '/door/conversations/send',
-    'conversation.answer': '/door/conversations/interaction/answer',
-    'conversation.interrupt': '/door/conversations/interrupt',
-    'conversation.kill': '/door/conversations/kill',
-    'conversation.cancel': '/door/conversations/cancel',
-    'conversation.delete': '/door/conversations/delete',
-    'conversation.history': '/door/conversations/history',
-    'conversations/interaction/read': '/door/conversations/interaction/read',
-    'conversations/originals/read': '/door/conversations/originals/read'
-};
+const CONVERSATION_ROUTES = new Map([
+    [
+        'conversation.create',
+        '/door/conversations/create'
+    ],
+    [
+        'conversation.send',
+        '/door/conversations/send'
+    ],
+    [
+        'conversation.answer',
+        '/door/conversations/interaction/answer'
+    ],
+    [
+        'conversation.interrupt',
+        '/door/conversations/interrupt'
+    ],
+    [
+        'conversation.kill',
+        '/door/conversations/kill'
+    ],
+    [
+        'conversation.cancel',
+        '/door/conversations/cancel'
+    ],
+    [
+        'conversation.delete',
+        '/door/conversations/delete'
+    ],
+    [
+        'conversation.history',
+        '/door/conversations/history'
+    ]
+]);
 export const HOUSE_CONVERSATION_CARDS = {
-    locator: PRIVATE_AUTHORITY,
+    locator: PRIVATE_LOCATOR,
     type: 'conversation',
     identity: 'conversation',
     agent: 'agent'
 };
-export function declaredActions() {
-    return HOUSE_PROVIDER_ACTIONS.map((name)=>({
-            name,
+export function declaredActions(routes) {
+    const mapped = new Map([
+        ...CONVERSATION_ROUTES
+    ].map(([name, route])=>[
+            route.slice('/door/'.length),
+            name
+        ]));
+    return routes.map((route)=>({
+            name: mapped.get(route) ?? route,
             inputShape: {},
             resultKind: 'house'
         }));
 }
 export function houseAction(transport, request) {
-    if (!DECLARED.has(request.name)) {
-        return Promise.resolve({
-            kind: 'rejected',
-            code: 'action-unimplemented',
-            fields: {
-                name: request.name,
-                mdModel: VERSION
-            }
-        });
-    }
     if (request.name === 'conversation.send') return sendAction(transport, request.input);
     if (request.name === 'conversation.history') return historyAction(transport, request.input);
-    return carry(transport, request.name, request.input);
+    const route = routeOf(request.name);
+    if (route === null) return Promise.resolve(malformed());
+    return carry(transport, route, request.name, request.input);
 }
 function routeOf(name) {
-    return CONVERSATION_ROUTES[name] ?? `/door/${name}`;
+    const mapped = CONVERSATION_ROUTES.get(name);
+    if (mapped !== undefined) return mapped;
+    const parts = name.split('/');
+    if (parts.some((part)=>part === '.' || part === '..')) return null;
+    try {
+        return `/door/${parts.map(encodeURIComponent).join('/')}`;
+    } catch  {
+        return null;
+    }
 }
 function record(value) {
     return typeof value === 'object' && value !== null ? value : {};
@@ -186,6 +143,13 @@ export function actionOutcome(answer, name) {
             fields: refusal.fields
         };
     }
+    if (answer.status === 404) return {
+        kind: 'rejected',
+        code: 'action-unimplemented',
+        fields: {
+            name
+        }
+    };
     if (answer.status === 0 || answer.status >= 400) return {
         kind: 'transport-uncertainty'
     };
@@ -198,8 +162,8 @@ export function actionOutcome(answer, name) {
         result: answer.body
     };
 }
-async function carry(transport, name, input) {
-    const answer = await transport.door(routeOf(name), bodyOf(name, input));
+async function carry(transport, route, name, input) {
+    const answer = await transport.door(route, bodyOf(name, input));
     return actionOutcome(answer, name);
 }
 function sendFile(entry) {
@@ -307,148 +271,79 @@ async function sendAction(transport, input) {
     return outcome;
 }
 function historyCursor(value) {
-    let parsed;
-    try {
-        parsed = JSON.parse(value);
-    } catch  {
-        return null;
-    }
-    const acceptedAt = text(parsed, 'accepted_at');
-    const messageId = text(parsed, 'message_id');
+    const acceptedAt = text(value, 'accepted_at');
+    const messageId = text(value, 'message_id');
     if (acceptedAt === undefined || messageId === undefined) return null;
     return {
         accepted_at: acceptedAt,
         message_id: messageId
     };
 }
-function turned(entry) {
-    const turn = text(entry, 'message_id');
-    if (turn === undefined) return null;
-    return {
-        turn,
-        message: structuredClone(entry)
-    };
-}
-function olderCursor(entry) {
-    const acceptedAt = text(entry.message, 'accepted_at');
-    const messageId = text(entry.message, 'message_id');
-    if (acceptedAt === undefined || messageId === undefined) return null;
+function position(cursor) {
     return JSON.stringify({
-        accepted_at: acceptedAt,
-        message_id: messageId
+        accepted_at: cursor.accepted_at,
+        message_id: cursor.message_id
     });
 }
-export async function readConversationHistory(transport, conversationId) {
-    const messages = [];
-    let after;
-    for(;;){
-        const answer = await transport.door('/door/conversations/history', {
-            conversation_id: conversationId,
-            ...after === undefined ? {} : {
-                after
-            },
-            limit: HISTORY_PAGE
-        });
-        const outcome = actionOutcome(answer, 'conversation.history');
-        if (outcome.kind !== 'action') return {
-            outcome
-        };
-        const held = record(outcome.result);
-        if (!Array.isArray(held.messages)) return {
-            outcome: {
-                kind: 'transport-uncertainty'
-            }
-        };
-        for (const entry of held.messages){
-            if (text(entry, 'message_id') === undefined) {
-                return {
-                    outcome: {
-                        kind: 'transport-uncertainty'
-                    }
-                };
-            }
-            messages.push(entry);
-        }
-        if (held.next === null || held.next === undefined) return {
-            messages
-        };
-        const next = record(held.next);
-        const acceptedAt = text(next, 'accepted_at');
-        const messageId = text(next, 'message_id');
-        if (acceptedAt === undefined || messageId === undefined) {
-            return {
-                outcome: {
-                    kind: 'transport-uncertainty'
-                }
-            };
-        }
-        after = {
-            accepted_at: acceptedAt,
-            message_id: messageId
-        };
+function positionCursor(value) {
+    try {
+        return historyCursor(JSON.parse(value));
+    } catch  {
+        return null;
     }
 }
-function historyPage(conversationId, messages, until) {
-    const from = Math.max(0, until - HISTORY_PAGE);
-    const page = messages.slice(from, until);
-    const first = page[0];
-    const cursor = from === 0 || first === undefined ? null : olderCursor(first);
-    if (from > 0 && cursor === null) return {
-        kind: 'transport-uncertainty'
-    };
+export function acceptedMessage(entry) {
+    const cursor = historyCursor(entry);
+    if (cursor === null) return null;
     return {
-        kind: 'action',
-        result: {
-            conversation_id: conversationId,
-            messages: page,
-            ...cursor === null ? {} : {
-                cursor
-            }
-        }
+        identity: cursor.message_id,
+        turn: cursor.message_id,
+        position: position(cursor),
+        text: text(entry, 'text') ?? '',
+        message: structuredClone(entry)
     };
 }
 async function historyAction(transport, input) {
     const conversationId = text(input, 'conversation');
     if (conversationId === undefined) return malformed();
-    const cursorValue = text(input, 'cursor');
-    let olderThan;
-    if (cursorValue !== undefined) {
-        const parsed = historyCursor(cursorValue);
-        if (parsed === null) {
-            return {
-                kind: 'rejected',
-                code: 'unknown-cursor',
-                fields: {
-                    cursor: cursorValue
-                }
-            };
-        }
-        olderThan = parsed;
-    }
-    const held = await readConversationHistory(transport, conversationId);
-    if ('outcome' in held) return held.outcome;
+    const afterValue = text(input, 'after');
+    const after = afterValue === undefined ? undefined : positionCursor(afterValue);
+    if (after === null) return malformed();
+    const answer = await transport.door('/door/conversations/history', {
+        conversation_id: conversationId,
+        ...after === undefined ? {} : {
+            after
+        },
+        limit: HISTORY_PAGE
+    });
+    const outcome = actionOutcome(answer, 'conversation.history');
+    if (outcome.kind !== 'action') return outcome;
+    const held = record(outcome.result);
+    if (!Array.isArray(held.messages)) return {
+        kind: 'transport-uncertainty'
+    };
     const messages = [];
     for (const entry of held.messages){
-        const mapped = turned(entry);
-        if (mapped === null) return {
+        const message = acceptedMessage(entry);
+        if (message === null) return {
             kind: 'transport-uncertainty'
         };
-        messages.push(mapped);
-    }
-    if (olderThan === undefined) {
-        return historyPage(conversationId, messages, messages.length);
-    }
-    const at = messages.findIndex((entry)=>text(entry.message, 'accepted_at') === olderThan.accepted_at && text(entry.message, 'message_id') === olderThan.message_id);
-    if (at === -1) {
-        return {
-            kind: 'rejected',
-            code: 'unknown-cursor',
-            fields: {
-                cursor: cursorValue
-            }
-        };
+        messages.push(message);
     }
-    return historyPage(conversationId, messages, at);
+    const next = held.next === null || held.next === undefined ? undefined : historyCursor(held.next);
+    if (next === null) return {
+        kind: 'transport-uncertainty'
+    };
+    const page = {
+        messages,
+        ...next === undefined ? {} : {
+            next: position(next)
+        }
+    };
+    return {
+        kind: 'action',
+        result: page
+    };
 }
 
 //# sourceMappingURL=actions.js.map