@plurnk/plurnk-grammar 0.74.40 → 0.74.44

package/package.json

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

package/plurnk.md

@@ -42,8 +42,8 @@ The `(target)` is required for every operation except PLAN, EXEC, and SEND.
 <<EDIT(path):literal text:EDIT is only for adding or modifying files and entries. Do not attempt to edit log items.
 <<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.
+<<FOLD(log path)::FOLD hides (`-`) the log item body (saves tokens). FOLDed item tokens="" shows token cost if OPENed.
+<<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 EXEC streams or worker runs.
@@ -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
@@ -104,7 +115,7 @@ Body content is character-perfect, exactly matching whitespace.
 ## Imperatives
 
 YOU MUST ONLY use EXEC for actions that can't be performed with other Plurnk OPs.
-YOU MUST distill, FOLD, or KILL log items as necessary to optimize active context relevance within the token budget.
+YOU MUST distill, FOLD, or KILL log items as necessary to avoid and recover from active context Budget Overflow errors. Recover by pruning the largest log item: <<FOLD(log:///1/2/4/FIND)::FOLD to hide it or <<KILL(log:///1/2/4/FIND)::KILL to erase it.
 YOU SHOULD document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown:/// entries.
 YOU SHOULD distill source information into taxonomized, tagged, and topical known:/// entries.
 
@@ -116,7 +127,7 @@ YOU MUST terminate the turn by SENDing a message to the user with the proper sta
 
 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):List the capitals in: known:///continents/europe:COPY
 To fork the current run: <<COPY(run://self):Re-derive the capital from a primary source.:COPY
 
 ## Examples
@@ -144,15 +155,16 @@ To fork the current run: <<COPY(run://self):Re-derive the capital from a primary
 * <<KILL(sh:///3/1/2)::KILL
 * <<KILL[9](sh:///3/1/3)::KILL
 * <<KILL(log:///1/*/*/FOLD)::KILL
-* <<OPEN(log:///**/get)<1,10>::OPEN
+* <<OPEN(log:///**)<1,10>::OPEN
 * <<FIND(known:///**)<5>:~french revolutionary history:FIND
 * <<FIND(known:///**)<0.7>:~french territorial concessions:FIND
-* <<FOLD(log:///**/get)<101,200>::FOLD
+* <<FOLD(log:///**)<101,200>::FOLD
 * <<FIND(log:///**/error):#budget overflow|budget exceeded#i:FIND
 * <<FIND(known:///**):revolution:FIND
 * <<FIND(known:///**):$[?(@.role=="admin")]:FIND
 * <<FIND(#(draft|final)/.*#i)::FIND
 * <<FIND(#src/.*\.test\.ts#)::FIND
 * <<FIND(src/**):@<createCoder:FIND
+* <<FIND(**/notes.md)::FIND
 * <<SEND(run://capital-checker):{"hint":"known entries are your persistent memory"}:SEND
 * <<EDIT[tutorial,training,scripts](example.sh):echo "Taxonomic path names and topical tags on files, entries, and items improve reasoning and recall!" > advice.txt:EDIT