@plurnk/plurnk-schemes-http 1.17.0 → 1.18.0
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/docs/https.md +10 -6
- package/docs/wss.md +8 -4
- package/package.json +4 -4
package/docs/https.md
CHANGED
|
@@ -15,12 +15,12 @@ every READ names the page's other channels with their tokens.
|
|
|
15
15
|
|
|
16
16
|
| Operation | Remote action | Effect |
|
|
17
17
|
| ---------------------------------------------- | ------------- | ------------------------------------------------------------------------- |
|
|
18
|
-
|
|
|
19
|
-
|
|
|
20
|
-
|
|
|
21
|
-
|
|
|
22
|
-
|
|
|
23
|
-
|
|
|
18
|
+
| `READ (https://…) <scope?>` | GET if needed | Acquire/reuse the complete response, then return the selected scoped text |
|
|
19
|
+
| `FIND (https://…) [{"pattern": …}]` | GET if needed | Return matching text regions for a scoped READ |
|
|
20
|
+
| `SEND (https://…)` with body | POST | Submit the body and stream the response |
|
|
21
|
+
| `EDIT (https://…)` with body | PUT | Replace the whole remote resource; do not use a line scope |
|
|
22
|
+
| `KILL (https://…)` | none | Cancel a live acquisition of the address, or forget its stored response |
|
|
23
|
+
| `KILL (https://…) [{"remote": true}]` | DELETE | Delete the remote resource and stream the response |
|
|
24
24
|
|
|
25
25
|
A path-pattern FIND searches only web entries already materialized in the
|
|
26
26
|
workspace; a pattern cannot discover the remote web. For matched content, READ
|
|
@@ -111,6 +111,10 @@ target, one header per block:
|
|
|
111
111
|
{"done":true}
|
|
112
112
|
````
|
|
113
113
|
|
|
114
|
+
````SEND (https://api.example.com/v1/search) [{"Content-Type": "application/json"}]
|
|
115
|
+
{"query":"plurnk"}
|
|
116
|
+
````
|
|
117
|
+
|
|
114
118
|
Metadata stays on one line; nested braces are preserved as content.
|
|
115
119
|
An exact FIND forwards these headers when it must acquire the URL, but the
|
|
116
120
|
result remains intentionally ineligible for later cache reuse. Request headers
|
package/docs/wss.md
CHANGED
|
@@ -10,11 +10,11 @@ while EDIT, SEND, and KILL address that connection.
|
|
|
10
10
|
|
|
11
11
|
| Operation | Effect |
|
|
12
12
|
| ---------------------------------------------- | --------------------------------------------------------------------------------------- |
|
|
13
|
-
|
|
|
13
|
+
| `READ (wss://host/path)` | Claim the address, connect, mark `messages` active on `open`, and stream inbound frames |
|
|
14
14
|
| A second READ of the same address | Read the retained representation; reuse the existing connection without reconnecting |
|
|
15
|
-
|
|
|
16
|
-
|
|
|
17
|
-
|
|
|
15
|
+
| `EDIT (wss://host/path)` with body | Send one whole text frame through an already-open connection; ranges and batches are invalid |
|
|
16
|
+
| `SEND (wss://host/path)` with body | Send one whole text frame; it may follow the opening READ in the same turn |
|
|
17
|
+
| `KILL (wss://host/path)` | Close or cancel the connection; an address with no connection is `404` |
|
|
18
18
|
|
|
19
19
|
| Connection state | Meaning | EDIT or directed SEND |
|
|
20
20
|
| ------------ | ---------------------------------------------------- | ------------------------------------------------ |
|
|
@@ -41,6 +41,10 @@ turn's disposition operation is deferred until the other operations have run.
|
|
|
41
41
|
{"type":"subscribe","channel":"updates"}
|
|
42
42
|
````
|
|
43
43
|
|
|
44
|
+
````SEND (wss://api.example.com/feed)
|
|
45
|
+
{"type":"ping"}
|
|
46
|
+
````
|
|
47
|
+
|
|
44
48
|
Connection identity includes the workspace, exact `ws`/`wss` protocol, host,
|
|
45
49
|
non-default port, path, and ordered query. A fragment does not change socket
|
|
46
50
|
identity; `messages` is the only current channel. An unavailable channel returns
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-schemes-http",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.18.0",
|
|
4
4
|
"description": "HTTP(S) request/response and WebSocket scheme handlers for the plurnk agent runtime.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"plurnk",
|
|
@@ -74,11 +74,11 @@
|
|
|
74
74
|
"prepack": "npm run build"
|
|
75
75
|
},
|
|
76
76
|
"peerDependencies": {
|
|
77
|
-
"@plurnk/plurnk-schemes": "^1.
|
|
77
|
+
"@plurnk/plurnk-schemes": "^1.18.0"
|
|
78
78
|
},
|
|
79
79
|
"dependencies": {
|
|
80
|
-
"@plurnk/plurnk-contracts": "1.
|
|
81
|
-
"@plurnk/plurnk-meta": "1.
|
|
80
|
+
"@plurnk/plurnk-contracts": "1.18.0",
|
|
81
|
+
"@plurnk/plurnk-meta": "1.18.0",
|
|
82
82
|
"eventsource-parser": "^4.0.0"
|
|
83
83
|
}
|
|
84
84
|
}
|