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

package/AGENTS.md

@@ -11,8 +11,14 @@ Rooms, Slots, Query, Search, Observe, Types, Room Draft, Save, History, Call, Lo
 storage loss, the reported persistence answer, deployment facts, Sync Status, reauthorization,
 conversation, the chat draft, and Presentation State.
 
+Every `observe` resolves, once its first value has arrived, to a handle:
+`current()` is the latest complete value, `subscribe(listener)` hears each later
+value whole and returns its unsubscribe, and `close()` ends the observation.
+Closing the port ends every handle and rejects every pending call and
+observation; a client that reconnects observes again.
+
 Each conversation a Provider card names is held complete in the browser.
-Observe one with `observe('conversation', id, { limit }, listener)`: the view
+Observe one with `observe('conversation', id, { limit })`: 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;
@@ -30,7 +36,7 @@ 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
+`observe('deployment-facts')`. 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.
 
@@ -39,8 +45,10 @@ ships in no bundle.
 
 ## 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:
+`query(q)` answers once from local state; `observe('query', q)` holds the whole
+result and hears it again only when it changes, keeping every unchanged Document
+the same object, so a component can tell what changed by identity. 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
@@ -103,7 +111,8 @@ 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
+base. A binary link target has a Room Draft too, for a move or a removal, with
+`null` as its 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,
@@ -111,8 +120,8 @@ 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.
+Room Draft in place. A directory move or removal is a move or removal part on
+each Document and binary link target beneath it, saved together.
 
 Outcomes follow the Provider's answer. Accepted advances the confirmed
 layer. Conflicted and Rejected, an expired outcome record, and a change that no

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/mdruntime-adapter",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.22",
   "description": "Agents House Adapter for the MD Runtime",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     "url": "https://github.com/agentshouse/mdruntime/issues"
   },
   "dependencies": {
-    "@agentshouse/mdmodel": "0.1.0-alpha.14",
-    "@agentshouse/mdruntime": "0.1.0-alpha.26"
+    "@agentshouse/mdmodel": "0.1.0-alpha.15",
+    "@agentshouse/mdruntime": "0.1.0-alpha.28"
   }
 }