@plurnk/plurnk-schemes-http 1.14.2 → 1.16.0

package/docs/https.md

@@ -15,11 +15,12 @@ are never presented by default.
 
 | Operation                                      | Remote action | Effect                                                                    |
 | ---------------------------------------------- | ------------- | ------------------------------------------------------------------------- |
-| `## READ0 (https://…) <scope?>`              | GET if needed | Acquire/reuse the complete response, then return the selected scoped text |
-| `## FIND0 (https://…)` with matcher body     | GET if needed | Prepare an exact URL, then return flat match locations                    |
-| `## SEND0 [200] (https://…)` with body       | POST          | Submit the body and stream the response                                  |
-| `## EDIT0 (https://…)` with body             | PUT           | Replace the whole remote resource; do not use a line scope               |
-| `## KILL0 (https://…)`                       | DELETE        | Delete the remote resource and stream the response                       |
+| `### READ0 (https://…) <scope?>`              | GET if needed | Acquire/reuse the complete response, then return the selected scoped text |
+| `### FIND0 (https://…)` with matcher body     | GET if needed | Prepare an exact URL, then return flat match locations                    |
+| `### SEND0 (https://…)` with body             | POST          | Submit the body and stream the response                                  |
+| `### EDIT0 (https://…)` with body             | PUT           | Replace the whole remote resource; do not use a line scope               |
+| `### KILL0 (https://…)`                       | none          | Cancel a live acquisition of the address, or forget its stored response  |
+| `### KILL0 (https://…) {remote}`              | DELETE        | Delete the remote resource and stream the response                       |
 
 A path-pattern FIND searches only web entries already materialized in the
 workspace; a pattern cannot discover the remote web. FIND returns navigation
@@ -98,10 +99,10 @@ forms therefore have identical selection and scope semantics.
 Request headers are ordered `{Key: value}` metadata blocks after the complete
 target, one header per block:
 
-```plurnk
-## READ0 (https://api.example.com/v1/me) {Authorization: Bearer TOKEN} {Accept: application/json}
+```example
+### READ0 (https://api.example.com/v1/me) {Authorization: Bearer TOKEN} {Accept: application/json}
 
-## EDIT0 (https://api.example.com/v1/thing/42) {Authorization: Bearer TOKEN} {Content-Type: application/json}
+### EDIT0 (https://api.example.com/v1/thing/42) {Authorization: Bearer TOKEN} {Content-Type: application/json}
 {"done":true}
 ```
 
@@ -116,9 +117,9 @@ GET acquisition of a GitHub `…/blob/…` URL uses its
 `raw.githubusercontent.com` source. The addressed GitHub URL remains entry
 identity. POST, PUT, and DELETE never use that rewrite.
 
-| Control                  | Effect                                                                |
-| ------------------------ | --------------------------------------------------------------------- |
-| `## SEND0 [499] (https://…)` | Cancel the routed in-flight acquisition                               |
-| `## SEND0 [410] (https://…)` | Delete the local stored response; the next READ must acquire it again |
+A `KILL` of an https:// address never reaches the remote unless it carries the `{remote}`
+block: while an acquisition is in flight it cancels that acquisition, otherwise it forgets
+the stored response so the next READ must acquire it again. With `{remote}`, any other
+metadata blocks are the DELETE request's headers.
 
 For a persistent bidirectional connection, use `wss://`.

package/docs/wss.md

@@ -11,12 +11,11 @@ that owner.
 
 | Operation                                      | Effect                                                                                  |
 | ---------------------------------------------- | --------------------------------------------------------------------------------------- |
-| `## READ0 (wss://host/path)`                   | Claim the address, connect, mark `messages` active on `open`, and stream inbound frames |
+| `### READ0 (wss://host/path)`                   | Claim the address, connect, mark `messages` active on `open`, and stream inbound frames |
 | A second READ of the same address              | Return `409` until the existing owner's terminal cleanup releases the claim             |
-| `## EDIT0 (wss://host/path)` with body         | Send one whole text frame through an already-open owner; ranges and batches are invalid  |
-| `## SEND0 [200] (wss://host/path)` with body   | Send one whole text frame; it may follow the opening READ in the same turn               |
-| `## SEND0 [499] (wss://host/path)`             | Cancel the owning READ through its routed subscription handle                           |
-| `## KILL0 (wss://host/path)`                   | Close or cancel the claimed owner; an address with no owner is `404`                    |
+| `### EDIT0 (wss://host/path)` with body         | Send one whole text frame through an already-open owner; ranges and batches are invalid  |
+| `### SEND0 (wss://host/path)` with body         | Send one whole text frame; it may follow the opening READ in the same turn               |
+| `### KILL0 (wss://host/path)`                   | Close or cancel the claimed owner; an address with no owner is `404`                    |
 
 | Owner state  | Meaning                                              | EDIT or SEND with signal `200`                   |
 | ------------ | ---------------------------------------------------- | ------------------------------------------------ |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-schemes-http",
-    "version": "1.14.2",
+    "version": "1.16.0",
     "description": "HTTP(S) request/response and WebSocket scheme handlers for the plurnk agent runtime.",
     "keywords": [
         "plurnk",
@@ -74,9 +74,10 @@
         "prepack": "npm run build"
     },
     "peerDependencies": {
-        "@plurnk/plurnk-schemes": "^1.14.2"
+        "@plurnk/plurnk-schemes": "^1.16.0"
     },
     "dependencies": {
+        "@plurnk/plurnk-meta": "1.16.0",
         "eventsource-parser": "^4.0.0"
     }
 }