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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/mdruntime-adapter",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.21",
   "description": "Agents House Adapter for the MD Runtime",
   "license": "MIT",
   "type": "module",
@@ -34,6 +34,6 @@
   },
   "dependencies": {
     "@agentshouse/mdmodel": "0.1.0-alpha.14",
-    "@agentshouse/mdruntime": "0.1.0-alpha.26"
+    "@agentshouse/mdruntime": "0.1.0-alpha.27"
   }
 }