@agentshouse/mdruntime-adapter 0.1.0-ca5b2f7fcb9d1 → 0.1.0-ca69607040f50

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -8,22 +8,19 @@ Repository, change it, build, and push. They are documentation, not enforcement.
8
8
  App code reaches the MD Runtime through the remote client. The surfaces are Rooms,
9
9
  Query, Search, Observe, Types, Room Draft, Save, History, the binary file reads, Call,
10
10
  Reached, Log, the reported persistence answer, reauthorization, conversation, the chat
11
- draft, and Presentation State. Sync Status, the Service Mode, the storage-loss
11
+ draft, and Presentation State. Sync Status, readiness, the Service Mode, the storage-loss
12
12
  statement, the deployment facts and the signed-in member are observations only.
13
13
 
14
14
  The host attaches each port with its reach, and every member and observation answers
15
15
  within it: a Room outside it answers as one the replica does not hold, Rooms lists only
16
- the Rooms reached whole, a Room reached for single Documents shows only those Documents
17
- and the Types of the models that govern them, and without conversations the conversation
18
- members, the chat draft and the conversation observation hold none. A change of the
19
- reach reaches every open observation as its new value, a query keeping unchanged
20
- Documents the same objects.
16
+ the Rooms reached whole, a Room reached for single Documents shows only them and the Types
17
+ of their models, and without conversations the conversation members, chat draft and
18
+ observation hold none. A changed reach reaches every open observation as its new value.
21
19
 
22
20
  Every `observe` resolves, once its first value has arrived, to a handle: `current()` is
23
- the latest complete value, `subscribe(listener)` hears each later value whole and
24
- returns its unsubscribe, and `close()` ends the observation. Closing the port ends every
25
- handle and rejects every pending call and observation; a client that reconnects observes
26
- again.
21
+ the latest complete value, `subscribe(listener)` hears each later value whole and returns
22
+ its unsubscribe, and `close()` ends the observation. Closing the port ends every handle
23
+ and rejects every pending call and observation; a client that reconnects observes again.
27
24
 
28
25
  `observe('agents')` answers every Agent a new conversation can go to, each `{ identity,
29
26
  name }`, whether or not it has a conversation yet. Each conversation the Provider's
@@ -39,24 +36,35 @@ questions, the process state, and the CLI's commands and options. These live onl
39
36
  memory: the message accepted under the turn's id replaces the running turn, and none of
40
37
  them is stored or searchable. `chatDraft.write` and `chatDraft.discard` keep what the
41
38
  App Creator composes; sending it is a Provider Action that needs the Provider reachable
42
- and is never queued.
39
+ and is never queued. A new conversation's chat draft is the one keyed `new:<Agent
40
+ identity>`: no conversation list removes it, a retired Agent's goes, and the first answer
41
+ to `conversation.create({ agent_id, operation_id })` moves it to the created conversation,
42
+ where `conversation.send(conversation)` sends it; a replay of that create moves nothing.
43
+
44
+ Presentation State is one value per App, kept in the browser and shared by every tab of
45
+ the App. `presentation.read()` answers it, `null` before anything is kept, and
46
+ `observe('presentation')` hears it whole. `presentation.write(value)` replaces it whole.
47
+ `presentation.edit(members)` sets each member the object names and removes one named
48
+ `null`, in the state as it stands, so tabs changing different members never lose
49
+ each other's change: change a member with `edit`, never by writing back a value read
50
+ before, which drops what another tab changed meanwhile. Both reject when the browser does
51
+ not keep the change, and then no tab sees it.
43
52
 
44
53
  A binary file at a Path is a binary Path entry. Query lists it by `path`, and History
45
54
  each of its revisions, with its `binaryFile` record and never its bytes: `{ state:
46
55
  'accepted', revision, path, fileRef, byteLength, mediaType, sha256 }`, or, from a Save
47
- until the Provider accepts it, `{ state: 'pending', localId, path, byteLength,
48
- mediaType, sha256 }`. Write one with a Room Draft whose only part is `file: { blob }`,
49
- the `Blob`'s `type` its media type: Save keeps the bytes in its Pending Change, offline
50
- too, and acceptance gives the record the Provider's revision. Move or remove one as a
51
- Document, a pending one before or after Save too, its bytes following; once its Pending
52
- Change has gone to the Provider, Save refuses that as `unknown-revision` until it is
53
- accepted. `binaryFile.read(room, path, revision?)` answers a pending record's saved
54
- bytes, or asks the Provider again on every read of an accepted one or of a History
55
- revision, a removed file's last included, keeping nothing. Text, a Record attachment or
56
- a conversation message may name a file by its `fileRef`; read it with
57
- `binaryFile.readReference({ fileRef, referrer })`, the referrer being the `referrer` the
58
- Provider gave beside it, or `{ room, path }` of the document whose text names it. Both
59
- answer `{ kind: 'binary', blob }` or a refusal or failure.
56
+ until the Provider accepts it, `{ state: 'pending', localId, path, byteLength, mediaType,
57
+ sha256 }`. Write one with a Room Draft whose only part is `file: { blob }`, the `Blob`'s
58
+ `type` its media type: Save keeps the bytes in its Pending Change, offline too, and
59
+ acceptance gives the record the Provider's revision. Move or remove one as a Document, a
60
+ pending one before or after Save too, its bytes following; once its Pending Change has
61
+ gone to the Provider, Save refuses that as `unknown-revision` until it is accepted.
62
+ `binaryFile.read(room, path, revision?)` answers a pending record's saved bytes, or asks
63
+ the Provider on every read of an accepted one or a History revision, a removed file's
64
+ last included, keeping nothing. Text, a Record attachment or a conversation message may
65
+ name a file by its `fileRef`; read it with `binaryFile.readReference({ fileRef, referrer
66
+ })`, the `referrer` the Provider gave beside it, or `{ room, path }` of the document
67
+ whose text names it. Both answer `{ kind: 'binary', blob }` or a refusal or failure.
60
68
 
61
69
  Rooms, Query, Search, Observe, Types, Room Draft, Save, and Reached never touch the
62
70
  network. History, the binary file reads and Call go to the Provider through the Adapter.
@@ -77,7 +85,9 @@ other than its result, a refused Save or Room Draft write, a returned Room Draft
77
85
  reason, a Room's refusal and the Connection Refusal, and every error a member rejects
78
86
  with, beside its message. A Provider refusal carries the Provider's own `retryable`.
79
87
  Every code and every value the API answers is open: handle one you do not know by its
80
- `code` and `retryable`.
88
+ `code` and `retryable`. Only a tag telling which fields a value carries, such as an
89
+ answer's `kind`, is closed so it narrows: keep a branch for a tag you do not know. A
90
+ model with no usable types answers `types: null`, whatever its `status`.
81
91
 
82
92
  Read the deployment facts with `observe('deployment-facts')`, an opaque value the host's
83
93
  contract interprets. `observe('member')` answers who uses the App: the User the Provider
@@ -104,35 +114,37 @@ observe the query to hear the complete one. A query is data:
104
114
  - **Fields.** Every frontmatter value is named by JSON Pointer: `/status`,
105
115
  `/shipping/city`, `~1` for a `/` and `~0` for a `~` in a key. A segment that meets a
106
116
  list applies to every item and a number names one item. `where` names pointers, ANDs
107
- them, and nests `$and` and `$or`; a pointer through a list holds when any item
108
- satisfies it. A bare value is equality; the operators are `$eq`, `$ne`, `$in`, `$nin`,
109
- `$gt`, `$gte`, `$lt`, `$lte`, `$all`, `$size` and `$exists`. Equality on a list asks
110
- whether it contains the value. Missing, null and empty differ: `$exists: false` keeps
111
- a missing field, `null` an explicit null, `''` empty text and `$size: 0` an empty
112
- list. A date compares in calendar order and never with a date-time. A reference
113
- compares by the Room Path it resolves to. Untyped frontmatter, and a value under
114
- `oneOf` or a conditional, is plain values. There is no text containment or regular
115
- expression.
117
+ them, and nests `$and` and `$or`; a pointer through a list holds if any item satisfies
118
+ it. A bare value is equality; the operators are `$eq`, `$ne`, `$in`, `$nin`, `$gt`,
119
+ `$gte`, `$lt`, `$lte`, `$all`, `$size` and `$exists`. Equality on a list asks if it
120
+ contains the value. Missing, null and empty differ: `$exists: false` keeps a missing
121
+ field, `null` an explicit null, `''` empty text and `$size: 0` an empty list. A date
122
+ compares in calendar order and never with a date-time. A reference compares by the
123
+ Room Path it resolves to. Untyped frontmatter, and a value under `oneOf` or a
124
+ conditional, is plain values. There is no text containment or regular expression.
116
125
  - **Relations.** `hop: { field, types, where, pathPrefix }` keeps Documents whose
117
126
  reference at pointer `field`, at any depth, points to a matching Document of the same
118
127
  Room. `backlinks: { field, types, where, pathPrefix }` keeps Documents that a matching
119
128
  Document of the same Room references. Each keeps a Document once.
120
129
  - **Parts.** A Document query must `select`: `'all'`, or `fields`, `sections`,
121
- `preamble`, `markdown`, `backlinks` and `change`, where `fields` is `'all'` or a list
122
- of pointers and `sections` `'all'` or a list of names. Selected pointers return the
123
- frontmatter holding only them, nested as written. A backlink names the referring Path,
124
- MD Type and the pointer it came from as `field`. Room and Path always return; a
125
- Markdown Document also returns its MD Type. A non-Markdown Document returns only Room
126
- and Path, and a binary Path entry Room, Path and its `binaryFile` record, whatever is
127
- selected. An unselected part is absent. Select only what a screen shows: a list that
130
+ `preamble`, `markdown`, `backlinks`, `change` and `fileId`, where `fields` is `'all'`
131
+ or a list of pointers and `sections` `'all'` or a list of names. Selected pointers
132
+ return the frontmatter holding only them, nested as written. A backlink names the
133
+ referring Path, MD Type and the pointer it came from as `field`. Room and Path always
134
+ return; a Markdown Document also returns its MD Type. A non-Markdown Document returns
135
+ only Room, Path and a selected `fileId`, and a binary Path entry its `binaryFile`
136
+ record too. An unselected part is absent. Select only what a screen shows: a list that
128
137
  selects the Markdown hears every edit of it.
129
138
  - **Change.** `change` is `{ author, time }` of the Document's head revision as the
130
- Provider last delivered it: `author` is `{ kind: 'user' | 'site', id, name }` or
131
- `null` for a write the Provider made itself, and `time` is the Provider's ISO 8601
132
- change time. It is `null` where the Provider delivered no time, as at a Site. An
133
- unsent edit or move keeps it, an unsent creation has none, and a saved write takes the
134
- Provider's own once it is Accepted. A Room's last change is its Document with the
135
- latest `time`.
139
+ Provider last delivered it: `author` is `{ kind: 'user' | 'site', id, name }` or `null`
140
+ for a write the Provider made itself, and `time` is the Provider's ISO 8601 change
141
+ time. It is `null` where the Provider delivered no time, as at a Site. An unsent edit
142
+ or move keeps it, an unsent creation has none, and a saved write takes the Provider's
143
+ own once it is Accepted. A Room's last change is its Document with the latest `time`.
144
+ - **File ID.** `fileId` is the Provider's Stable File ID of the file at the Path, or
145
+ `null` where the Provider supplies none. An unsent edit keeps it, an unsent move
146
+ carries it to the new Path, and an unsent creation has none until it is Accepted, so a
147
+ file ID that leaves one Path for another is the same file moved.
136
148
  - **Order and groups.** `orderBy` sorts by `room`, `path`, `type` or `{ field }` with
137
149
  TanStack DB's own options, and ties end with Room, then Path. `groupBy` by `room`,
138
150
  `type` or `{ field }` answers `{ groups: [{ key, count }] }`, counted over every match
@@ -143,65 +155,64 @@ observe the query to hear the complete one. A query is data:
143
155
  `current` false while a newer copy of that Room is being fetched, and the queued
144
156
  changes it includes as `overlay`; a Save in a Room changes the `overlay` of every
145
157
  query over it. An invalid query fails with the `code` `invalid-query`, `unknown-type`,
146
- `unknown-field` or `wrong-kind`, naming where, and never answers an empty result in
147
- its place.
158
+ `unknown-field` or `wrong-kind`, naming where, and never answers empty in its place.
148
159
 
149
160
  ## Local Search rules
150
161
 
151
- `search({ text, documents, conversations, limit })` answers once, by words, from local
152
- state, with MiniSearch's defaults. There is no observed search.
162
+ `search({ text, documents, collection, conversations, limit })` answers once, by words,
163
+ from local state, with MiniSearch's defaults. There is no observed search.
153
164
 
165
+ - **Declaration.** Only an App whose release declares Local Search searches, its first
166
+ readiness waiting for its index; any other App's `search` answers the never retryable
167
+ `undeclared` refusal `search-undeclared`, its `fields` naming `local_search`.
154
168
  - **What is found.** A Document by its field values, its sections' headings and text,
155
169
  its preamble and its Path; a message by its text. Frontmatter keys, Room Drafts, chat
156
170
  drafts and a running turn's parts are never found. There are no phrases, word forms,
157
171
  typo tolerance or prefix matching.
158
- - **Narrowing.** `documents` is a Local Query filter: `rooms`, `types`, `where`,
159
- `pathPrefix`, `hop` and `backlinks`. `conversations` names conversations. Both apply
160
- before `limit`, which bounds each list; without it every hit returns.
161
- - **Results.** `{ documents, messages, coverage }`, or `{ pending }` naming each Room or
162
- conversation the search waits for while its index is prepared: ask again, and never
172
+ - **Narrowing.** `documents` is a Local Query filter, and `collection: true` leaves out
173
+ what each Room's `typedSelection` roots hold; `conversations` names conversations. All
174
+ apply before `limit`, which bounds each list; without it every hit returns.
175
+ - **Results.** `{ documents, messages, coverage }`, or the same with `pending` naming each
176
+ Room or conversation the search still waits for: show its hits, ask again, and never
163
177
  read pending as no hits. `coverage` names the Rooms and conversations searched. Each
164
- list is ranked by `score`, which compares hits of one list of one search. A Document
165
- hit names its `room`, `path` and `type`, a message hit its `conversation` and
166
- `identity`, and `matches` maps each matched word to the parts it matched in: `fields`,
167
- `sections`, `preamble` or `path`, or `text`. A hit carries no position; mark the words
168
- in the text you show. An invalid filter fails with its Local Query error.
178
+ list is ranked by `score`, comparable only within it; tied Documents come by `room`,
179
+ then `path`. A Document hit names its `room`, `path` and `type`, a message hit its
180
+ `conversation` and `identity`; `matches` maps each matched word to the parts it matched
181
+ in: `fields`, `sections`, `preamble`, `path` or `text`. A hit carries no position: mark
182
+ the words in the text you show. An invalid filter fails with its Local Query error.
169
183
 
170
184
  ## Room Draft, Save, and outcome rules
171
185
 
172
186
  The MD Runtime owns one Room Draft per Room and Path, shared by every App and tab. It is
173
- durable: it survives reload and navigation. A Room that Discovery stops listing takes
174
- its Room Drafts and its queue with it. Write a Room Draft with `roomDraft.write(room,
175
- path, revision, parts)`, naming the revision you read, or `null` when there was none,
176
- and every part it should now change: fields, sections and the preamble, or the whole
177
- Markdown, a creation, a move, or a removal. A part new to the Room Draft names its base,
178
- the value you showed when it was opened; the MD Runtime keeps a part's first base; a
179
- binary Path entry's move or removal takes `null` as its base. A write or a discard from
180
- an older revision is refused as `stale` with the current Room Draft; read it and write
181
- again.
187
+ durable: it survives reload and navigation. A Room the Provider reports lost takes its
188
+ Room Drafts and its queue with it. Write a Room Draft with `roomDraft.write(room, path,
189
+ revision, parts)`, naming the revision you read, or `null` when there was none, and every
190
+ part it should now change: fields, sections and the preamble, or the whole Markdown, a
191
+ creation, a move, or a removal. A part new to the Room Draft names its base, the value
192
+ you showed when it was opened, a field's as `{ value }` or `null` when the Document had no
193
+ such field; the MD Runtime keeps a part's first base; a binary Path
194
+ entry's move or removal takes `null` as its base. A write or a discard from an older
195
+ revision is refused as `stale` with the current Room Draft; read it and write again.
182
196
 
183
197
  Save takes one Room and the Room Drafts of it to save, each with its revision, validates
184
198
  locally, and on success appends one Change Batch to that Room's queue and removes those
185
199
  Room Drafts. It is refused with the `code` `stale`, `changed-underneath` naming each
186
200
  part whose base no longer matches the visible state, or a local validation rule, and
187
201
  then creates nothing and leaves every Room Draft in place. A directory move or removal
188
- is a move or removal part on each Document and binary Path entry beneath it, saved
189
- together.
190
-
191
- Outcomes follow the Provider's answer. An Accepted Change Batch stays in the queue,
192
- drawn over the confirmed layer, until the confirmed layer reaches the Room Version it
193
- was accepted at, and then leaves it. Conflicted and Rejected, an expired operation, and
194
- a change that no longer applies over the Room each leave the queue and return as Room
195
- Drafts on the Documents they changed, marked with why: the Provider's structured refusal
196
- code and fields as returned, not known to have applied, or withdrawn locally. The rest
197
- of the queue keeps synchronizing, and Sync Status requires attention until each returned
198
- Room Draft is saved again or discarded. A Change Batch keeps no outcome once it leaves
199
- the queue; `observe('queue', room)` shows each Pending one, and a returned Room Draft
200
- says why it returned. Transport failure and Provider unavailability keep work Pending
201
- and do not infer a rejection. A refusal the Provider marks retryable stays Pending until
202
- the reset it names; the MD Runtime retries the same Change Batch identity and payload
203
- and never infers an outcome from transport uncertainty. The MD Runtime never combines,
204
- reorders, or rebases.
202
+ is that part on each Document and binary Path entry beneath it, saved together.
203
+
204
+ Outcomes follow the Provider's answer. An Accepted Change Batch stays in the queue, drawn
205
+ over the confirmed layer, until that layer reaches the Room Version it was accepted at,
206
+ then leaves it. Conflicted and Rejected, an expired operation, and a change that no
207
+ longer applies over the Room each leave the queue and return as Room Drafts on their
208
+ Documents, marked with why: the Provider's structured refusal code and fields as
209
+ returned, not known to have applied, or withdrawn locally. The rest of the queue keeps
210
+ synchronizing, and Sync Status requires attention until each returned Room Draft is saved
211
+ or discarded. A Change Batch keeps no outcome once it leaves the queue; `observe('queue',
212
+ room)` shows each Pending one. Transport failure and Provider unavailability keep work
213
+ Pending, as does a refusal the Provider marks retryable until the reset it names; the MD
214
+ Runtime retries the same Change Batch identity and payload, never infers an outcome from
215
+ transport uncertainty, and never combines, reorders, or rebases.
205
216
 
206
217
  On a Site, every Save stays in the visitor's browser. Write grants and revisions do not
207
218
  refuse it, and its Pending Change shows in every query and across reloads until the
@@ -210,46 +221,46 @@ browser's storage is cleared. It is never sent: `observe('queue', room)` shows i
210
221
  applies, it leaves the queue and returns no Room Draft.
211
222
 
212
223
  `observe('service-mode')` answers the Provider's Service Mode, `open` or `write-halted`.
213
- While writes are halted, Save still succeeds, its Change Batch waits unsent, and the
214
- queue is submitted in order once the Provider reopens writes. An Action is never held: a
215
- write the Provider refuses for the halt returns that refusal to its caller. Show the
216
- Provider as read-only instead of retrying.
217
-
218
- ## The neutrality rule
219
-
220
- No module outside an Adapter package imports, names, or special-cases a Provider. MD UI
221
- and every App reach data only through the client entry.
224
+ While writes are halted, Save still succeeds, its Change Batch waits unsent, and the queue
225
+ is submitted in order once writes reopen. An Action is never held: one the halt refuses
226
+ returns that refusal to its caller. Show the Provider as read-only instead of retrying.
227
+ `observe('readiness')` tells whether the App's code and bound Rooms are held locally
228
+ (`ready`), each Room's state, each refused Room's file and rule, the persistence answer
229
+ and a paused preparation's `capacity` cause; `retry()` resumes a paused preparation.
222
230
 
223
231
  ## Content-safety rules
224
232
 
225
- The Provider authorization belongs to the Runtime host and is never readable by the
226
- App's code. The App's code reaches the network only at the external origins its manifest
227
- declares, empty by default, and the Provider enforces that set. Every request to the
228
- Provider itself goes through the MD Runtime. Rendered Markdown never executes scripts,
229
- renders raw HTML only for the details and summary elements, and loads images and other
230
- resources only from origins the Provider's policy allows.
233
+ The Provider authorization belongs to the Runtime host and is never readable by the App's
234
+ code. The App's code reaches the network only at the external origins its manifest
235
+ declares, empty by default, and the Provider enforces that set. Rendered Markdown never
236
+ executes scripts, renders raw HTML only for the details and summary elements, and loads
237
+ images and other resources only from origins the Provider's policy allows.
231
238
 
232
239
  ## Launch promises MD UI keeps
233
240
 
234
241
  MD UI uses semantic HTML, is fully operable from a keyboard with visible focus and
235
242
  labelled controls, and lays out from a 360 pixel wide viewport to a desktop. Its strings
236
243
  are English only, dates and numbers follow the browser locale, and content is never
237
- translated. Light and dark themes come from CSS custom properties with the browser's
238
- preference as the default and an App's override respected. What an App Creator's agent
239
- adds carries none of these promises by itself. Reading, querying and searching never
240
- wait for the network. Data lives only in the App Creator's browser and with the
241
- Provider.
244
+ translated. Light and dark themes come from CSS custom properties, defaulting to the
245
+ browser's preference and respecting an App's override. What an agent adds carries none of
246
+ these promises by itself. Data lives only in the App Creator's browser and the Provider.
242
247
 
243
248
  ## App code takes the client its host hands it and never constructs a Runtime
244
249
 
245
- App code takes the client its host hands it: in House, `houseBridge().runtime` from
246
- `@agentshouse/app-bridge` resolves to the client House built into the page. It imports
247
- only types from `@agentshouse/mdruntime/client`, never calls `connectMdRuntime` or
248
- `serveMdRuntime`, and never imports the package main, the host entry or the Adapter
249
- package, which hosts and tests use. The in-memory Adapter at
250
+ No module outside an Adapter package imports, names, or special-cases a Provider, and
251
+ every App and MD UI reach data only through the client entry. In House,
252
+ `houseBridge().runtime` from `@agentshouse/app-bridge` resolves to the client House built
253
+ into the page. App code imports only types from `@agentshouse/mdruntime/client`, never
254
+ calls `connectMdRuntime` or `serveMdRuntime`, and never imports the package main, the host
255
+ entry or the Adapter package, which hosts and tests use. The in-memory Adapter at
250
256
  `@agentshouse/mdruntime/memory` is for tests and ships in no bundle. A Site's page fills
251
257
  its Entry Data Contract's `{"$param": name}` arguments with `boundQuery` from
252
- `@agentshouse/mdruntime/entry`, as House did for its HTML.
258
+ `@agentshouse/mdruntime/entry`, as House did for its HTML. While the Site prepares, each
259
+ query a route's `interaction` names answers from the entry's result when the page observes
260
+ that same descriptor, and every other stays pending. House replaces its HTML with the page
261
+ once its document changed after those answers, or readiness is `ready`, and then held
262
+ still for two animation frames, unless the visitor uses the HTML: draw the route from them
263
+ at once, never behind a placeholder. Before readiness is `ready`, `push` loads a new page.
253
264
 
254
265
  A React App may observe and save through `@agentshouse/mdruntime/react`, which names
255
266
  React as a peer dependency. `useObserve(client, topic, ...input)` takes the arguments of
@@ -260,8 +271,10 @@ nothing and stays loading. `useSave(client)` returns `busy`, the last `outcome`
260
271
  Draft already there, keeping the bases its parts have, or onto a new one, and saves them
261
272
  together. A refused Save leaves the Room Drafts for the App to save again or discard; a
262
273
  failure is recorded and rejects. `saveRoomDrafts(client, room, roomDrafts)` is that save
263
- outside a component. A react-admin or Refine App reads and writes its Rooms through the
264
- data providers of `@agentshouse/mdruntime-families`.
274
+ outside a component. An App that writes its Room Drafts itself saves them with
275
+ `saveWritten(room, roomDrafts)`, each named with the revision its last write returned: one
276
+ another tab wrote since is refused as `stale`, and nothing is saved. A react-admin or
277
+ Refine App uses the data providers of `@agentshouse/mdruntime-families`.
265
278
 
266
279
  ## The Chat
267
280
 
@@ -286,9 +299,8 @@ Mix `ChatMessageList` (`components` takes your `UserMessage` and `AssistantMessa
286
299
  compose assistant-ui's primitives there; `useChat()` gives `send`, the conversations,
287
300
  the Agents, questions to `answer`, `options` to `choose`, `commands`, the queue to
288
301
  `edit` or `unqueue`, `stop`, `kill` and outcomes; never replace its messages, sending or
289
- store. A secret question is never answered here; typed answers live in Presentation
290
- State's `typed` key: keep it, and change Presentation State only inside `inTurn(client,
291
- work)` from `@agentshouse/mdruntime/client`. `Markdown` draws Markdown safely.
302
+ store. A secret question is never answered here; typed answers live in the Presentation
303
+ State members named `typed:…`: leave them. `Markdown` draws Markdown safely.
292
304
 
293
305
  ## What an agent must never do
294
306
 
@@ -1 +1 @@
1
- {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
package/dist/actions.js CHANGED
@@ -140,6 +140,8 @@ export function actionOutcome(answer, name) {
140
140
  if (answer.status === 401)
141
141
  return { kind: 'revoked-authorization' };
142
142
  const refusal = doorRefusal(answer.body);
143
+ if (refusal?.code === 'operation_contended')
144
+ return { kind: 'transport-uncertainty' };
143
145
  if (refusal !== null)
144
146
  return { kind: 'rejected', ...refusal };
145
147
  if (answer.status === 404)
@@ -1 +1 @@
1
- {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EACP,aAAa,EAiBd,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,CA+gBpF"}
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,OAAO,EACP,aAAa,EAkBd,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,CAyiBpF"}
package/dist/adapter.js CHANGED
@@ -134,7 +134,7 @@ export function createAgentsHouseAdapter(options) {
134
134
  const models = await streamedModels(advanced.schemas, entry, 'credential');
135
135
  return models === undefined ? advanced.page : { ...advanced.page, models };
136
136
  }
137
- function held(rooms) {
137
+ function held(rooms, demand) {
138
138
  const kept = rooms.flatMap((room) => {
139
139
  const entry = tracked.get(room.locator);
140
140
  const at = logPosition(room.roomVersion);
@@ -144,7 +144,7 @@ export function createAgentsHouseAdapter(options) {
144
144
  notifications.reach(entry.authority, at);
145
145
  return [presented(entry.authority, at)];
146
146
  });
147
- notifications.send(kept);
147
+ notifications.send(kept, demand === null ? null : { rooms: [...demand.rooms], conversations: demand.conversations });
148
148
  }
149
149
  function adopted(entry, outcome) {
150
150
  if (outcome.kind !== 'accepted')
@@ -352,7 +352,7 @@ export function createAgentsHouseAdapter(options) {
352
352
  return UNCERTAIN;
353
353
  return mutationOutcome(settled.status, settled.body, entry.locator, entry.handle);
354
354
  }
355
- async function downloaded(answer, locator) {
355
+ function granted(answer, locator) {
356
356
  const failure = classifyDoor(answer.status, answer.body, locator);
357
357
  if (failure !== null) {
358
358
  return failure.kind === 'scoped-refusal'
@@ -365,13 +365,31 @@ export function createAgentsHouseAdapter(options) {
365
365
  : failure;
366
366
  }
367
367
  const grant = parseGrant(answer.body);
368
- if (grant === null || grant.method !== 'GET')
368
+ const name = answer.body.name;
369
+ if (grant === null || grant.method !== 'GET' || typeof name !== 'string') {
369
370
  return UNCERTAIN_READ;
370
- const read = await transport.download(grant.url);
371
+ }
372
+ return { kind: 'link', url: grant.url, name };
373
+ }
374
+ async function downloaded(answer, locator) {
375
+ const link = granted(answer, locator);
376
+ if (link.kind !== 'link')
377
+ return link;
378
+ const read = await transport.download(link.url);
371
379
  if (read.status !== 200 || read.blob === null)
372
380
  return UNCERTAIN_READ;
373
381
  return { kind: 'binary', blob: read.blob };
374
382
  }
383
+ function pathGrant(request) {
384
+ const entry = authorityFor(request.locator);
385
+ if (entry === undefined)
386
+ return null;
387
+ return transport.door(DOOR_FILES_GET, {
388
+ room_ref: entry.authority,
389
+ path: request.path,
390
+ revision: request.revision,
391
+ });
392
+ }
375
393
  return {
376
394
  async authorize() {
377
395
  return options.authorize();
@@ -456,15 +474,10 @@ export function createAgentsHouseAdapter(options) {
456
474
  },
457
475
  async binary(_authorization, request) {
458
476
  if (request.kind === 'path') {
459
- const entry = authorityFor(request.locator);
460
- if (entry === undefined)
477
+ const asked = pathGrant(request);
478
+ if (asked === null)
461
479
  return { kind: 'room-not-readable', locator: request.locator };
462
- const answer = await transport.door(DOOR_FILES_GET, {
463
- room_ref: entry.authority,
464
- path: request.path,
465
- revision: request.revision,
466
- });
467
- return downloaded(answer, request.locator);
480
+ return downloaded(await asked, request.locator);
468
481
  }
469
482
  const referrer = houseReferrer(request.referrer, tracked);
470
483
  if (referrer === null) {
@@ -476,6 +489,12 @@ export function createAgentsHouseAdapter(options) {
476
489
  });
477
490
  return downloaded(answer, referrer.locator);
478
491
  },
492
+ async link(_authorization, request) {
493
+ const asked = pathGrant(request);
494
+ if (asked === null)
495
+ return { kind: 'room-not-readable', locator: request.locator };
496
+ return granted(await asked, request.locator);
497
+ },
479
498
  referrerScope(referrer) {
480
499
  const held = houseReferrer(referrer, tracked);
481
500
  if (held === null)
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
1
  export { createAgentsHouseAdapter, type AgentsHouseAdapterOptions } from './adapter.js';
2
2
  export { HOUSE_APP_ACTS, HOUSE_APP_BATCHES, HOUSE_SITE_ACTS } from './actions.js';
3
- export type { HouseByteAct, HouseByteTransfer, HouseBytesAnswer, HouseDoorAnswer, HouseHeldRoom, HouseOpening, HouseStream, HouseStreamEntry, HouseStreamFrame, HouseSiteTransport, HouseTransport, } from './transport.js';
3
+ export type { HouseByteAct, HouseByteTransfer, HouseBytesAnswer, HouseClosing, HouseDemand, HouseDoorAnswer, HouseHeldRoom, HouseOpening, HouseStream, HouseStreamEntry, HouseStreamFrame, HouseSiteTransport, HouseTransport, } from './transport.js';
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}
package/dist/read.d.ts CHANGED
@@ -3,6 +3,9 @@ import type { TrackedAuthority } from './discovery.js';
3
3
  import type { HouseMode } from './transport.js';
4
4
  import { type LogPosition } from './version.js';
5
5
  export type HeadChange = BootstrapPage['changes'][string];
6
+ export declare function identities(revisions: Readonly<Record<string, string>>): {
7
+ fileIds?: Record<string, string>;
8
+ };
6
9
  export type HouseManifestFile = {
7
10
  path: string;
8
11
  revision: string | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"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"}
package/dist/read.js CHANGED
@@ -1,4 +1,12 @@
1
1
  import { DECIMAL, readPosition, roomVersion } from './version.js';
2
+ const REVISION_FILE = /^fr_([0-9a-z]+)\.[0-9a-z]+\.[0-9a-z]$/u;
3
+ export function identities(revisions) {
4
+ const fileIds = Object.fromEntries(Object.entries(revisions).flatMap(([path, revision]) => {
5
+ const file = REVISION_FILE.exec(revision)?.[1];
6
+ return file === undefined ? [] : [[path, file]];
7
+ }));
8
+ return Object.keys(fileIds).length === 0 ? {} : { fileIds };
9
+ }
2
10
  export function authorityRoot(handle) {
3
11
  return `/rooms/${handle}`;
4
12
  }
@@ -353,6 +361,7 @@ export function bootstrapOf(scope) {
353
361
  roomVersion: roomVersion(scope),
354
362
  documents,
355
363
  revisions,
364
+ ...identities(revisions),
356
365
  changes,
357
366
  binaryFiles,
358
367
  };
@@ -396,6 +405,7 @@ export function refreshFrom(view, fromRoomVersion) {
396
405
  roomVersion: roomVersion(view),
397
406
  documents,
398
407
  revisions,
408
+ ...identities(revisions),
399
409
  changes,
400
410
  binaryFiles,
401
411
  removals: removals.sort(),
@@ -1 +1 @@
1
- {"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAOR,MAAM,wBAAwB,CAAC;AA2BhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAmCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,UAAQ,GAAG,OAAO,CA8Q1F"}
1
+ {"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAUR,MAAM,wBAAwB,CAAC;AA2BhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAyCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAyR1F"}
package/dist/site.js CHANGED
@@ -9,6 +9,9 @@ import { SITE_DOOR_BOOTSTRAP, SITE_DOOR_DISCOVER, SITE_DOOR_ENUMERATE, SITE_DOOR
9
9
  import { houseReferrer } from './referrer.js';
10
10
  import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
11
11
  const UNCERTAIN = { kind: 'transport-uncertainty' };
12
+ function unfound() {
13
+ return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
14
+ }
12
15
  function siteRoom(tracked) {
13
16
  return {
14
17
  name: tracked.handle,
@@ -30,6 +33,18 @@ export function createSiteAdapter(transport, snapshot = false) {
30
33
  const named = houseReferrer(referrer, tracked);
31
34
  return named === null || !tracked.has(named.locator) ? null : named;
32
35
  }
36
+ function fileRoute(request) {
37
+ const named = published(request.kind === 'path' ? { room: request.locator, path: request.path } : request.referrer);
38
+ if (named === null) {
39
+ return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
40
+ }
41
+ if (request.fileRef === undefined)
42
+ return unfound();
43
+ const { room_ref, path, record } = named.referrer;
44
+ return `${SITE_FILES}${room_ref}/${encodeURIComponent(request.fileRef)}/${path === undefined
45
+ ? `${SITE_FILE_RECORD}/${encodeURIComponent(record)}`
46
+ : encodeURIComponent(path)}`;
47
+ }
33
48
  async function enumerated(entry, from, page) {
34
49
  const answer = await transport.door(SITE_DOOR_ENUMERATE, {
35
50
  positions: [
@@ -198,24 +213,26 @@ export function createSiteAdapter(transport, snapshot = false) {
198
213
  return { kind: 'no-history' };
199
214
  },
200
215
  async binary(_authorization, request) {
201
- const named = published(request.kind === 'path' ? { room: request.locator, path: request.path } : request.referrer);
202
- if (named === null) {
203
- return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
204
- }
205
- if (request.fileRef === undefined) {
206
- return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
207
- }
208
- const { room_ref, path, record } = named.referrer;
209
- const read = await transport.download(`${SITE_FILES}${room_ref}/${encodeURIComponent(request.fileRef)}/${path === undefined
210
- ? `${SITE_FILE_RECORD}/${encodeURIComponent(record)}`
211
- : encodeURIComponent(path)}`);
212
- if (read.status === 404) {
213
- return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
214
- }
216
+ const route = fileRoute(request);
217
+ if (typeof route !== 'string')
218
+ return route;
219
+ const read = await transport.download(route);
220
+ if (read.status === 404)
221
+ return unfound();
215
222
  return read.status === 200 && read.blob !== null
216
223
  ? { kind: 'binary', blob: read.blob }
217
224
  : UNCERTAIN;
218
225
  },
226
+ async link(_authorization, request) {
227
+ const route = fileRoute(request);
228
+ if (typeof route !== 'string')
229
+ return route;
230
+ return {
231
+ kind: 'link',
232
+ url: route,
233
+ name: request.path.slice(request.path.lastIndexOf('/') + 1),
234
+ };
235
+ },
219
236
  referrerScope(referrer) {
220
237
  const named = published(referrer);
221
238
  if (named === null)
@@ -253,7 +270,7 @@ export function createSiteAdapter(transport, snapshot = false) {
253
270
  return [];
254
271
  notifications.reach(entry.authority, at);
255
272
  return [presented(entry.authority, at)];
256
- }));
273
+ }), null);
257
274
  },
258
275
  reopen: notifications.reopen,
259
276
  observe: notifications.observe,
package/dist/stream.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import type { ConversationStream, RefreshPage, RoomStreamEvent, ServiceModeSignal, StreamReceipts } from '@agentshouse/mdruntime';
2
2
  import type { TrackedAuthority } from './discovery.js';
3
- import type { HouseDoor, HouseHeldRoom, HouseMode, HouseStreamEntry } from './transport.js';
3
+ import type { HouseDemand, HouseDoor, HouseHeldRoom, HouseMode, HouseStreamEntry } from './transport.js';
4
4
  import { type LogPosition } from './version.js';
5
5
  export type HeldRevision = (path: string, revision: string) => boolean;
6
6
  export type StreamedAdvancement = {
@@ -11,7 +11,7 @@ export type StreamedAdvancement = {
11
11
  export type HouseNotifications = {
12
12
  runtime: string;
13
13
  observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts): () => void;
14
- send(rooms: readonly HouseHeldRoom[]): void;
14
+ send(rooms: readonly HouseHeldRoom[], demand: HouseDemand | null): void;
15
15
  published(locator: string, at: LogPosition): void;
16
16
  reopen(): void;
17
17
  track(authorities: readonly TrackedAuthority[]): void;
@@ -1 +1 @@
1
- {"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAElB,WAAW,EACX,eAAe,EAEf,iBAAiB,EACjB,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAEb,SAAS,EAET,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AA0C7D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IACxF,IAAI,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,OAAO,CACL,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,YAAY,GACnB,mBAAmB,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAkFF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAmhB5F"}
1
+ {"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAElB,WAAW,EACX,eAAe,EAEf,iBAAiB,EACjB,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,aAAa,EAEb,SAAS,EAET,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AA0C7D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IACxF,IAAI,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,OAAO,CACL,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,YAAY,GACnB,mBAAmB,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAkFF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAwhB5F"}
package/dist/stream.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { acceptedMessage } from './actions.js';
2
2
  import { sha256Hex } from './digest.js';
3
- import { binaryFileOf, headChange } from './read.js';
3
+ import { binaryFileOf, headChange, identities } from './read.js';
4
4
  import { roomVersion } from './version.js';
5
5
  const HELD_FRAMES_MAX = 256;
6
6
  function turnOperation(frame) {
@@ -352,6 +352,10 @@ export function houseNotifications(transport, mode) {
352
352
  });
353
353
  return;
354
354
  }
355
+ if (frame.type === 'authority_changed') {
356
+ emit({ kind: 'authority-changed' });
357
+ return;
358
+ }
355
359
  if (frame.type === 'conversations') {
356
360
  emitConversation({ kind: 'list', entries: frame.conversations.map(listedConversation) });
357
361
  return;
@@ -421,10 +425,10 @@ export function houseNotifications(transport, mode) {
421
425
  });
422
426
  });
423
427
  stream.opened(reopened);
424
- stream.closed((revoked) => {
428
+ stream.closed(({ revoked, lost }) => {
425
429
  opening = null;
426
430
  acknowledging = null;
427
- emit({ kind: 'closed', revoked });
431
+ emit({ kind: 'closed', revoked, lost });
428
432
  });
429
433
  return {
430
434
  runtime,
@@ -463,7 +467,7 @@ export function houseNotifications(transport, mode) {
463
467
  observers.delete(notify);
464
468
  };
465
469
  },
466
- send(rooms) {
470
+ send(rooms, demand) {
467
471
  for (const room of rooms) {
468
472
  const line = lines.get(room.authority);
469
473
  const held = position(room.position);
@@ -478,7 +482,7 @@ export function houseNotifications(transport, mode) {
478
482
  void loaded
479
483
  .then(() => Promise.all(rooms.map(restored)))
480
484
  .then((presented) => {
481
- current.hold(presented, runtime);
485
+ current.hold(presented, runtime, demand);
482
486
  for (const [index, room] of presented.entries()) {
483
487
  if (room.position === rooms[index].position)
484
488
  continue;
@@ -601,6 +605,7 @@ export function houseNotifications(transport, mode) {
601
605
  roomVersion: roomVersion({ position: last.position.toString(), logEpoch: line.logEpoch }),
602
606
  documents,
603
607
  revisions,
608
+ ...identities(revisions),
604
609
  changes,
605
610
  binaryFiles,
606
611
  removals: removals.sort(),
@@ -80,6 +80,8 @@ export type HouseStreamFrame = {
80
80
  } | {
81
81
  type: 'opening';
82
82
  expired: readonly string[];
83
+ } | {
84
+ type: 'authority_changed';
83
85
  } | ({
84
86
  type: 'turn';
85
87
  conversation_id: string;
@@ -134,15 +136,23 @@ export type HouseHeldRoom = {
134
136
  log_epoch: string;
135
137
  carry?: HouseHeldCarry;
136
138
  };
139
+ export type HouseDemand = {
140
+ rooms: readonly string[];
141
+ conversations: boolean;
142
+ };
137
143
  export type HouseOpening = {
138
- hold(rooms: readonly HouseHeldRoom[], runtime: string): void;
144
+ hold(rooms: readonly HouseHeldRoom[], runtime: string, demand: HouseDemand | null): void;
139
145
  received(authority: string, carry: string, index: number): void;
140
146
  close(): void;
141
147
  };
148
+ export type HouseClosing = {
149
+ revoked: boolean;
150
+ lost: boolean;
151
+ };
142
152
  export type HouseStream = {
143
153
  observe(receive: (frame: HouseStreamFrame) => void): () => void;
144
154
  opened(notify: (opening: HouseOpening) => void): () => void;
145
- closed(notify: (revoked: boolean) => void): () => void;
155
+ closed(notify: (closing: HouseClosing) => void): () => void;
146
156
  };
147
157
  export type HouseDoor = {
148
158
  door(route: string, body: unknown): Promise<HouseDoorAnswer>;
@@ -1 +1 @@
1
- {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAElB,KAAK,cAAc,EAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/D,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAwHrD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAQ9E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAK/D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,MAAM,EAAE,CAQhF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAEpE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,uBAAuB,GAAG,kBAAkB,CAAC,GACtE,OAAO,CAKT;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;AAiDD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAkFhB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;IAEjF,IAAI,EAAE,UAAU;IAChB,QAAQ;IACR,IAAI;IACJ,MAAM;QAAI,IAAI;;IACd,SAAS;EAEZ;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM1B;AA4BD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,aAAa,CAyDf"}
1
+ {"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAElB,KAAK,cAAc,EAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/D,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAwHrD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAQ9E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAK/D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,MAAM,EAAE,CAQhF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAEpE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,uBAAuB,GAAG,kBAAkB,CAAC,GACtE,OAAO,CAKT;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;AAiDD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAmFhB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;IAEjF,IAAI,EAAE,UAAU;IAChB,QAAQ;IACR,IAAI;IACJ,MAAM;QAAI,IAAI;;IACd,SAAS;EAEZ;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM1B;AA4BD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,aAAa,CAyDf"}
package/dist/write.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { departure, } from '@agentshouse/mdruntime';
2
- import { binaryFileOf, headChange } from './read.js';
2
+ import { binaryFileOf, headChange, identities } from './read.js';
3
3
  import { sha256Hex, textBytes } from './digest.js';
4
4
  import { nativePath, roomLocalPath } from './map.js';
5
5
  import { classifyDoor, doorRefusal, scopedRefusal } from './refusal.js';
@@ -272,6 +272,7 @@ export function mutationOutcome(status, body, locator, handle) {
272
272
  roomVersion: roomVersion(at),
273
273
  documents,
274
274
  revisions,
275
+ ...identities(revisions),
275
276
  changes,
276
277
  removals: removals.sort(),
277
278
  ...(Object.keys(binaryFiles).length === 0 ? {} : { binaryFiles }),
@@ -340,7 +341,7 @@ export function historyOutcome(status, body, locator, request) {
340
341
  return {
341
342
  kind: 'scoped-refusal',
342
343
  locator,
343
- scope: 'content',
344
+ scope: 'operation',
344
345
  code: 'retained_history_unavailable',
345
346
  fields: { path: request.path, revision: request.revision },
346
347
  retryable: false,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentshouse/mdruntime-adapter",
3
- "version": "0.1.0-ca5b2f7fcb9d1",
3
+ "version": "0.1.0-ca69607040f50",
4
4
  "description": "Agents House Adapter for the MD Runtime",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -25,6 +25,6 @@
25
25
  "LICENSE"
26
26
  ],
27
27
  "dependencies": {
28
- "@agentshouse/mdruntime": "0.1.0-c89fa07b05d4b"
28
+ "@agentshouse/mdruntime": "0.1.0-c02c3f1090329"
29
29
  }
30
30
  }