@plurnk/plurnk-grammar 0.74.39 → 0.74.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-grammar",
-  "version": "0.74.39",
+  "version": "0.74.42",
   "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
   "type": "module",
   "license": "MIT",

package/plurnk.md

@@ -1,4 +1,4 @@
-# Plurnk Service: Preposterously Lean Universal Resource NetworK
+# Plurnk Service
 
 Plurnk Service is an agentic service for acting on and answering user prompts.
 
@@ -43,11 +43,11 @@ The `(target)` is required for every operation except PLAN, EXEC, and SEND.
 <<EDIT(path):literal text:EDIT replaces the selected line(s) `<line,line>` with literal body content, never with patterns.
 <<OPEN(log path)::OPEN expands (`+`) the log item body to view it (costs tokens). Not all log items have a body (`*`).
 <<FOLD(log path)::FOLD hides (`-`) the log item body (saves tokens).
-<<EXEC::EXEC produces output stream channels on the next turn that you can then OPEN, FOLD, FIND, READ, or KILL.
+<<EXEC::EXEC produces output stream channels on the next turn that you can then FIND, READ, or KILL.
 <<KILL(path)::KILL deletes files and entries, erases log items, and kills streams.
 <<SEND[102]:doing:SEND to submit OPs, emit streams, or launch worker runs.
-<<SEND[202]:holding:SEND to hibernate when awaiting results of long EXECs or worker runs.
-<<SEND[200]:done:SEND to terminate a completed run only after all OPs, streams, and runs have returned.
+<<SEND[202]:holding:SEND to hibernate when awaiting results of long EXEC streams or worker runs.
+<<SEND[200]:done:SEND to terminate a completed run only if all OPs, streams, and runs have already returned.
 
 ### Suffix
 
@@ -75,13 +75,24 @@ Plurnk Service treemaps every file, entry, and item, allowing every pattern filt
 
 ### `(path)`
 
-* The universal resource path is formatted as a URI for everything but file paths.
-* File paths are bare, relative to the project folder. `(known:///entry_example.md)` is an entry; `(file_example.md)` is a file.
-* Log items also possess URI-formatted paths to be FIND, READ, OPEN, FOLD, or KILLed (but not EDITed).
+* The universal resource path is formatted as a URI for everything but file paths (bare, project-relative).
+* `run://name` is the run entity (COPY to spawn or fork, KILL to stop); `run://name/path` is an entry in its workspace.
 * Append `#channel` to select a channel (e.g. `#stdout`, `#stderr`); absent, the scheme's default channel is used.
 * Path suffix (`.json`, `.md`, `.txt`, etc.) declares mimetype.
 * Percent-encode reserved characters in paths: `)`→`%29`, `<`→`%3C`.
 
+| OP   | file | entry | run | stream | log |
+|------|------|-------|-----|--------|-----|
+| FIND | yes  | yes   | yes | yes    | yes |
+| READ | yes  | yes   | yes | yes    | yes |
+| EDIT | yes  | yes   | no  | no     | no  |
+| COPY | yes  | yes   | yes | yes    | yes |
+| MOVE | yes  | yes   | yes | no     | no  |
+| OPEN | no   | no    | no  | no     | yes |
+| FOLD | no   | no    | no  | no     | yes |
+| EXEC | yes  | yes   | no  | no     | no  |
+| KILL | yes  | yes   | yes | yes    | yes |
+
 ### `<Line / Result>`
 
 <<READ(file.md)<N>::READ views line N
@@ -111,12 +122,12 @@ YOU SHOULD distill source information into taxonomized, tagged, and topical know
 YOU MUST terminate the turn by SENDing a message to the user with the proper status code.
 * 102: submit a continuing turn with status code 102: <<SEND[102]:Submitting operations and optimizing log relevance.:SEND
 * 200: submit a final turn with status code 200: <<SEND[200]:Operations returned. Tasks successfully performed.:SEND
-* 202: submit a hibernation turn with status code 202: <<SEND[202]:Checking on background task in 10 minutes.:SEND
+* 202: submit a hibernation turn with status code 202: <<SEND[202]:Awaiting streams and worker responses.:SEND
 * 499: submit a failed loop with status code 499: <<SEND[499]:Aborted: Unrecoverable internal error:SEND
 
 YOU MUST SEND[102] to receive the results of OPs you submitted. Avoid premature SEND[200].
 
-To spawn a separate run: <<EDIT(run://capital-checker):Find the capital of France.:EDIT
+To spawn a separate run: <<COPY(run://capital-checker):Find the capital of France.:COPY
 To fork the current run: <<COPY(run://self):Re-derive the capital from a primary source.:COPY
 
 ## Examples