@agentshouse/mdruntime-adapter 0.1.0-ccd2ccb1f7214 → 0.1.0-ccda1a2da11c3

package/AGENTS.md

@@ -5,8 +5,8 @@ change it, build, and push. They are documentation, not enforcement.
 
 ## The MD Runtime API
 
-App code reaches the MD Runtime through the remote client. The surfaces are Rooms,
-Query, Search, Observe, Types, Room Draft, Save, History, the binary file reads, Call,
+App code reaches the MD Runtime through the remote client. The surfaces are Rooms, Query,
+Search, Observe, Types, Room Draft, Save, History, Resolve, the binary file reads, Call,
 Reached, Log, the reported persistence answer, reauthorization, conversation, the chat
 draft, and Presentation State. Sync Status, readiness, the Service Mode, the storage-loss
 statement, the deployment facts and the signed-in member are observations only.
@@ -59,25 +59,29 @@ media type: Save keeps the bytes in its Pending Change, offline too, and accepta
 the record the Provider's revision. Move or remove one as a Document, a pending one too,
 its bytes following; once its Pending Change has gone to the Provider, Save refuses that
 as `unknown-revision` until it is accepted. `binaryFile.read(room, path, revision?)`
-answers a pending record's saved bytes, or asks the Provider on every read of an accepted
-one or a History revision, a removed file's last included, keeping nothing. Text, a Record
-attachment or a conversation message may name a file by its `fileRef`; read it with
-`binaryFile.readReference({ fileRef, referrer })`, the `referrer` the Provider gave beside
-it, or `{ room, path }` of the document whose text names it. Both answer
-`{ kind: 'binary', blob }` or a refusal or failure.
+answers a pending record's saved bytes, or an accepted one's or a History revision's, a
+removed file's last included: the first read asks the Provider and the browser keeps the
+bytes, and every later read of that revision, offline too, answers them from the browser.
+Text, a Record attachment or a conversation message may name a file by its `fileRef`; read
+it with `binaryFile.readReference({ fileRef, referrer })`, the `referrer` the Provider gave
+beside it, or `{ room, path }` of the document whose text names it, kept the same way. Both
+answer `{ kind: 'binary', stream, byteLength, mediaType }`, the bytes a `ReadableStream`
+of parts of at most a mebibyte, or a refusal or failure; read the stream to its end, or
+take it whole with `new Response(stream).blob()` where a screen needs one `Blob`.
 
 Rooms, Query, Search, Observe, Types, Room Draft, Save, and Reached never touch the
-network; History, the binary file reads and Call go to the Provider through the Adapter.
+network; History, a binary file read the browser does not keep yet and Call go to the
+Provider through the Adapter.
 Call takes the Action names the Adapter declares, any other answering `undeclared`. A Call
 result whose effect the Provider places in a Room carries `at`, that Room and Room
 Version: `reached(room, roomVersion)` answers whether the Room's confirmed state has
 reached it, refreshing the Room until it has, and `reached(room, roomVersion, path)`
 whether the held copy of that document was written later. A History revision names its
-author, `{ kind: 'user', id }` or `{ kind: 'site', id, name }`; History of a Path no
+author, `{ kind: 'user', id }` or `{ kind: 'site' | 'inbox', id, name }`; History of a Path no
 document holds answers the removed document's revisions, newest first, with `deleted:
 true`, which a link to the Path opens. Every member is asynchronous and every result a
 detached snapshot; nothing returns the authorization, performs a request the App's code
-composes, or exposes the browser store.
+composes, or exposes the browser store. A Room `rooms` names `locked` shows only online.
 
 Every refusal and failure carries `code` and `retryable`: each Call and History answer
 other than its result, a refused Save or Room Draft write, a returned Room Draft's reason,
@@ -101,8 +105,8 @@ named; signing out answers `null`, then ends the observation with the authorizat
 hears it again only when it changes, keeping every unchanged Document the same object, so
 a component can tell what changed by identity. `{ documents, coverage }` or `{ groups,
 coverage }` is complete for the Rooms its `coverage` names, and `{ pending }` names each
-Room not yet acquired or prepared, `[{ room, awaits }]`: never read it as empty, draw it
-as loading and observe the query to hear the complete answer. A query is data:
+Room not yet acquired, prepared or unlocked, `[{ room, awaits }]`: never read it as empty,
+draw it as loading and observe the query to hear the complete answer. A query is data:
 
 - **Filter.** `rooms` names Room locators and defaults to every Room. `types` names MD
   Types, and `any` names untyped Markdown Documents. `pathPrefix` is a directory: `notes`
@@ -119,10 +123,13 @@ as loading and observe the query to hear the complete answer. A query is data:
   compares in calendar order and never with a date-time. A reference compares by the
   Room Path it resolves to. Untyped frontmatter, and a value under `oneOf` or a
   conditional, is plain values. There is no text containment or regular expression.
-- **Relations.** `hop: { field, types, where, pathPrefix }` keeps Documents whose
-  reference at pointer `field`, at any depth, 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.
+- **Relations.** Within one Room, `hop: { field, types, where, pathPrefix }` keeps Documents
+  whose reference at pointer `field`, at any depth, points to a matching Document, and
+  `backlinks` with the same keys those a matching Document references, each once. A body
+  link, or a reference declaring `cross_room`, may name another Room's
+  `/rooms/<handle>/<path>`: `resolve(room, path, destination)` answers its `document`, the
+  `deleted` one's last `revision`, or `unreadable` where the App does not bind it or it is
+  locked.
 - **Parts.** A Document query must `select`: `'all'`, or `fields`, `sections`,
   `preamble`, `markdown`, `backlinks`, `change` and `fileId`, where `fields` is `'all'`
   or a list of pointers and `sections` `'all'` or a list of names. Selected pointers
@@ -134,21 +141,22 @@ as loading and observe the query to hear the complete answer. A query is data:
   `binaryFile` record too. An unselected part is absent. Select only what a screen shows:
   a list that selects the Markdown hears every edit of it.
 - **Change and file ID.** `change` is `{ author, time }` of the Document's head revision
-  as the Provider last delivered it: `author` is `{ kind: 'user' | 'site', id, name }`, or
+  as the Provider last delivered it: `author` is `{ kind: 'user' | 'site' | 'inbox', id, name }`, or
   `null` for a write the Provider made itself, and `time` its ISO 8601 change time, or the
   whole change `null` where it delivered no time, as at a Site. `fileId` is the Provider's
   Stable File ID of the file at the Path, or `null`. An unsent edit keeps both, an unsent
   move keeps the change and carries the file ID to the new Path, so a file ID that leaves
   one Path for another is the same file moved, and an unsent creation has neither until it
   is Accepted. A Room's last change is its Document with the latest `time`.
-- **Order and groups.** `orderBy` sorts by `room`, `path`, `type`, `folder` or `{ field }`
-  with TanStack DB's own options; ties end with Room, then Path. `groupBy` by `room`,
-  `type`, `folder` or `{ field }` answers `{ groups: [{ key, count }] }`, counted over every
-  match and ordered by `count` or a key. A sort or group takes only a single-value pointer.
-  `limit`, at most 1,000 whatever a query names, bounds the Documents or the groups, and a
-  result it cuts short names `next`: the same query with it as `after` reads the next
-  window, in the same order, ties included. `total: true` adds `total`, every match's
-  count. An observed window hears rows entering, leaving or changing, and `next`, `total`.
+- **Order and groups.** `orderBy` sorts by `room`, `path`, `type`, `folder` or `{ field }`: missing
+  and null first, last with `nulls: 'last'`, then numbers and booleans, then text by `locale` or
+  code point with `stringSort: 'lexical'`, then lists item by item; ties end with Room, then Path.
+  `groupBy` by `room`, `type`, `folder` or `{ field }` answers `{ groups: [{ key, count }] }`,
+  counted over every match and ordered by `count` or a key. A sort or group takes only a
+  single-value pointer. `limit`, at most 1,000 whatever a query names, bounds the Documents or the
+  groups, and a result it cuts short names `next`: the same query with it as `after` reads the next
+  window, in the same order, ties included. `total: true` adds `total`, every match's count. An
+  observed window hears rows entering, leaving or changing, and `next`, `total`.
 - **Results and errors.** A result carries no Room Version: read freshness from Rooms and
   Sync Status. `coverage` names each Room read as `{ room, generation, current }`,
   `current` false while a newer copy of that Room is being fetched, and the queued changes
@@ -185,22 +193,24 @@ once, by words, from local state, with MiniSearch's defaults. There is no observ
 
 The MD Runtime owns one durable Room Draft per Room and Path, shared by every App and tab
 across reloads; a Room the Provider reports lost takes its Room Drafts and queue with it.
-Write one with `roomDraft.write(room, path, revision, parts)`, naming the revision you
-read or `null`, and every part it now changes: fields, sections and the preamble, or the
-whole Markdown, a creation, a move or a removal. A new part names its base, the value you
-showed when it was opened, a field's as `{ value }` or `null` for no such field, and keeps
-its first base; a binary Path entry's move or removal takes `null`. A write or discard
-from an older revision is refused as `stale` with the current Room Draft.
+Write one with `roomDraft.write(room, path, revision, parts)`, naming the revision you read
+or `null`, and every part it now changes: fields, sections and the preamble, or the whole
+Markdown, a creation, a move, into another Room when it names `room`, or a removal. A new
+part names its base, the value you showed when it was opened, a field's as `{ value }` or
+`null` for no such field, and keeps its first base; a binary Path entry's move or removal
+takes `null`. A write or discard from an older revision is refused as `stale` with the
+current Room Draft.
 
 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. Refused as `stale`, `changed-underneath` naming each part whose base no
-longer matches the visible state, or a local validation rule, it creates nothing and
-leaves every Room Draft. A directory move or removal is that part on each Document and
-binary Path entry beneath it, saved together. `saveParts(room, [{ path, parts }])` saves
-parts, each Path once and each new part with its base, the same way but writes no Room
-Draft: one held at a saved Path stays, one at a moved Path moves with it to a destination
-that holds none. Never save by writing back a Room Draft read before.
+locally, and on success appends one Change Batch to that Room's queue and removes those Room
+Drafts. Refused as `stale`, `changed-underneath` naming each part whose base no longer
+matches the visible state, or a local validation rule, it creates nothing and leaves every
+Room Draft. A directory move or removal is that part on each Document and binary Path entry
+beneath it, saved together; moves into another Room, saved alone, are one Change Batch in
+both Rooms' queues. `saveParts(room, [{ path, parts }])` saves parts, each Path once and
+each new part with its base, the same way but writes no Room Draft: one held at a saved Path
+stays, one at a moved Path moves with it to a destination that holds none. Never save by
+writing back a Room Draft read before.
 
 Outcomes follow the Provider's answer. An Accepted Change Batch stays in the queue, drawn
 over the confirmed layer, until that layer reaches the Room Version it was accepted at.

package/dist/actions.d.ts

@@ -6,10 +6,11 @@ type Operated = {
 type ConversationControl = Operated & {
     readonly conversation: string;
 };
-type SentFile = FileDeclaration & {
-    readonly blob: Blob;
-};
 export type AppInputs = {
+    readonly 'conversation.attach': FileDeclaration & {
+        readonly room: string;
+        readonly blob: Blob;
+    };
     readonly 'conversation.answer': ConversationControl & {
         readonly answer: {
             readonly interaction_id: string;
@@ -25,11 +26,16 @@ export type AppInputs = {
     readonly 'conversation.kill': ConversationControl;
     readonly 'conversation.send': ConversationControl & {
         readonly operation_id: string;
-        readonly text?: string;
-        readonly files?: readonly SentFile[];
+        readonly text: string;
+    };
+    readonly 'trigger.list': {
+        readonly room_refs: readonly string[];
     };
 };
 export type AppAnswers = {
+    readonly 'conversation.attach': {
+        readonly path: string;
+    };
     readonly 'conversation.history': ConversationHistories;
 };
 export type AppAnswerAdditions = {

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/dist/actions.js

@@ -2,6 +2,7 @@ import { changeBatchIdentity, } from '@agentshouse/mdruntime';
 import { doorRefusal } from './refusal.js';
 const HISTORY_PAGE = 100;
 const HISTORY_CONVERSATIONS = 64;
+const TRIGGER_ROOMS = 100;
 const OCTET_STREAM = 'application/octet-stream';
 function mapped(door, input = (given) => given) {
     return {
@@ -11,16 +12,18 @@ function mapped(door, input = (given) => given) {
         },
     };
 }
-function carried(door, carry, batched) {
+function carried(door, carry, batched, room) {
     return {
         door,
         ...(batched === undefined ? {} : { batched }),
+        ...(room === undefined ? {} : { room }),
         carry: (transport, input, name) => carry(transport, `/door/${door}`, input, name),
     };
 }
 const APP_ACTS = {
     'access.read': mapped('rooms/access/read'),
     'conversation.answer': mapped('conversations/interaction/answer', answerBody),
+    'conversation.attach': carried('conversations/attach', attachAction, undefined, 'room'),
     'conversation.create': carried('conversations/create', createAction),
     'conversation.delete': mapped('conversations/delete', controlBody),
     'conversation.history': carried('conversations/history', historyAction, ['conversations']),
@@ -44,7 +47,7 @@ const APP_ACTS = {
     'routineAllowance.list': mapped('routines/allowance'),
     'routineRequest.list': mapped('routines/requests'),
     'storage.read': mapped('storage/inventory'),
-    'trigger.list': mapped('triggers/read'),
+    'trigger.list': carried('triggers/read', triggersAction, ['room_refs'], 'room_refs'),
     'triggerOccurrence.list': mapped('triggers/fired'),
 };
 export const HOUSE_APP_ACTS = Object.fromEntries(Object.entries(APP_ACTS).map(([name, act]) => [name, act.door]));
@@ -54,15 +57,15 @@ export const HOUSE_SITE_ACTS = {
 };
 export const HOUSE_APP_BATCHES = Object.fromEntries(Object.entries(APP_ACTS).flatMap(([name, act]) => act.batched === undefined ? [] : [[name, act.batched]]));
 const APP_NAMES = new Map(Object.entries(APP_ACTS).map(([name, act]) => [act.door, name]));
+const APP_ROOMS = new Map(Object.entries(APP_ACTS).flatMap(([name, act]) => act.room === undefined ? [] : [[name, act.room]]));
 export function houseConversationAgents(locator) {
     return { locator, type: 'house-agent', identity: 'agent', name: 'name', retired: 'retired' };
 }
 export function declaredActions(routes) {
-    return routes.map((route) => ({
-        name: APP_NAMES.get(route) ?? route,
-        inputShape: {},
-        resultKind: 'house',
-    }));
+    return routes.map((route) => {
+        const name = APP_NAMES.get(route) ?? route;
+        return { name, inputShape: {}, resultKind: 'house', room: APP_ROOMS.get(name) ?? 'room_ref' };
+    });
 }
 export function houseAction(transport, request) {
     if (Object.hasOwn(APP_ACTS, request.name)) {
@@ -180,106 +183,74 @@ async function recordsAction(transport, route, input, name) {
 async function carry(transport, route, name, input) {
     return actionOutcome(await transport.door(route, input), name);
 }
-function sendFile(entry) {
-    const file = record(entry);
-    const name = text(file, 'name');
-    const bytes = file.byteLength;
-    const sha256 = text(file, 'contentHash');
-    if (name === undefined || typeof bytes !== 'number' || sha256 === undefined)
-        return null;
-    const mediaType = text(file, 'mediaType');
-    const width = file.width;
-    const height = file.height;
-    return {
-        name,
-        media_type: mediaType !== undefined && mediaType.length > 0 ? mediaType : OCTET_STREAM,
-        bytes,
-        sha256,
-        ...(typeof width === 'number' && typeof height === 'number'
-            ? { dimensions: { width, height } }
-            : {}),
-    };
-}
-function sendFiles(input) {
-    const files = record(input).files;
-    if (files === undefined)
-        return [];
-    if (!Array.isArray(files))
-        return null;
-    const declared = [];
-    for (const entry of files) {
-        const file = sendFile(entry);
-        if (file === null)
-            return null;
-        declared.push(file);
-    }
-    return declared;
-}
 function sendBody(input) {
-    const files = sendFiles(input);
     const operation = text(input, 'operation_id');
-    if (files === null || operation === undefined)
+    const said = text(input, 'text');
+    if (operation === undefined || said === undefined)
         return null;
-    const textValue = text(input, 'text');
-    return {
-        conversation_id: text(input, 'conversation'),
-        operation_id: operation,
-        ...(textValue !== undefined && textValue.length > 0 ? { text: textValue } : {}),
-        ...(files.length === 0 ? {} : { files }),
-    };
+    return { conversation_id: text(input, 'conversation'), operation_id: operation, text: said };
+}
+async function sendAction(transport, route, input, name) {
+    const body = sendBody(input);
+    if (body === null)
+        return malformed();
+    const outcome = actionOutcome(await transport.door(route, body), name);
+    if (outcome.kind !== 'action')
+        return outcome;
+    return { ...outcome, result: withTurn(outcome.result) };
 }
-async function fileBytes(file) {
-    const blob = record(file).blob;
-    if (blob === undefined || typeof blob !== 'object' || blob === null)
+function attachBody(input) {
+    const room = text(input, 'room');
+    const name = text(input, 'name');
+    const sha256 = text(input, 'contentHash');
+    const bytes = record(input).byteLength;
+    if (room === undefined || name === undefined || sha256 === undefined)
         return null;
-    if (!('arrayBuffer' in blob) || typeof blob.arrayBuffer !== 'function')
+    if (typeof bytes !== 'number')
         return null;
-    return new Uint8Array(await blob.arrayBuffer());
+    const mediaType = text(input, 'mediaType');
+    return {
+        room_ref: room,
+        name,
+        bytes,
+        sha256,
+        media_type: mediaType !== undefined && mediaType.length > 0 ? mediaType : OCTET_STREAM,
+    };
 }
-function uploadGrant(entry) {
-    if (!('upload' in record(entry)))
-        return 'absent';
-    const upload = record(record(entry).upload);
+function uploadGrant(answer) {
+    const upload = record(record(answer).upload);
     if (upload.method !== 'POST')
         return null;
     if (typeof upload.operation !== 'string' || typeof upload.url !== 'string')
         return null;
-    return { method: 'POST', operation: upload.operation, url: upload.url };
-}
-async function uploadFiles(transport, input, result) {
-    const sent = record(result).files;
-    if (!Array.isArray(sent))
-        return true;
-    const files = Array.isArray(record(input).files) ? record(input).files : [];
-    for (const [index, entry] of sent.entries()) {
-        const grant = uploadGrant(entry);
-        if (grant === 'absent')
-            continue;
-        const bytes = index < files.length ? await fileBytes(files[index]) : null;
-        if (grant === null || bytes === null)
-            return false;
-        const answer = await transport.transfer({
-            act: 'conversation_file_upload',
-            url: grant.url,
-            body: bytes,
-            operation: grant.operation,
-        });
-        if (answer.status !== 200)
-            return false;
-    }
-    return true;
+    return { operation: upload.operation, url: upload.url };
 }
-async function sendAction(transport, route, input, name) {
-    const body = sendBody(input);
-    if (body === null)
+async function attachAction(transport, route, input, name) {
+    const body = attachBody(input);
+    const blob = record(input).blob;
+    if (body === null || !(blob instanceof Blob))
         return malformed();
     const outcome = actionOutcome(await transport.door(route, body), name);
     if (outcome.kind !== 'action')
         return outcome;
-    if (!(await uploadFiles(transport, input, outcome.result))) {
+    const grant = uploadGrant(outcome.result);
+    if (grant === null)
         return { kind: 'transport-uncertainty' };
+    const sent = await transport.transfer({
+        act: 'file_upload',
+        url: grant.url,
+        body: new Uint8Array(await blob.arrayBuffer()),
+        operation: grant.operation,
+    });
+    if (sent.status !== 200) {
+        const refusal = doorRefusal(sent.body);
+        return refusal === null ? { kind: 'transport-uncertainty' } : { kind: 'rejected', ...refusal };
     }
-    return { ...outcome, result: withTurn(outcome.result) };
+    const path = text(sent.body, 'path');
+    if (path === undefined)
+        return { kind: 'transport-uncertainty' };
+    const result = { path };
+    return { kind: 'action', result };
 }
 function historyCursor(value) {
     const acceptedAt = text(value, 'accepted_at');
@@ -303,19 +274,12 @@ export function acceptedMessage(entry) {
     const cursor = historyCursor(entry);
     if (cursor === null)
         return null;
-    const message = structuredClone(record(entry));
-    const referrer = { message: cursor.message_id };
     return {
         identity: cursor.message_id,
         turn: text(entry, 'turn_id') ?? cursor.message_id,
         position: position(cursor),
         text: text(entry, 'text') ?? '',
-        message: Array.isArray(message.files)
-            ? {
-                ...message,
-                files: message.files.map((file) => ({ ...record(file), referrer })),
-            }
-            : message,
+        message: structuredClone(record(entry)),
     };
 }
 function historyPage(entry) {
@@ -352,6 +316,22 @@ function historyAsks(input) {
     }
     return asks;
 }
+async function triggersAction(transport, route, input, name) {
+    const asked = record(input).room_refs;
+    if (!Array.isArray(asked) || asked.length === 0)
+        return malformed();
+    const rooms = [];
+    for (let at = 0; at < asked.length; at += TRIGGER_ROOMS) {
+        const outcome = actionOutcome(await transport.door(route, { room_refs: asked.slice(at, at + TRIGGER_ROOMS) }), name);
+        if (outcome.kind !== 'action')
+            return outcome;
+        const answered = record(outcome.result).rooms;
+        if (!Array.isArray(answered))
+            return { kind: 'transport-uncertainty' };
+        rooms.push(...answered);
+    }
+    return { kind: 'action', result: { rooms } };
+}
 async function historyAction(transport, route, input, name) {
     const asks = historyAsks(input);
     if (asks === null)

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EACP,aAAa,EAmBd,MAAM,wBAAwB,CAAC;AA4ChC,OAAO,EASL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAyBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAsErD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAsjBpF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EACP,aAAa,EAmBd,MAAM,wBAAwB,CAAC;AAuChC,OAAO,EASL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AA2BxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA4ErD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAunBpF"}