@plurnk/plurnk-grammar 0.74.48 → 0.74.50

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.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/plurnk.md +19 -19
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-grammar",
3
- "version": "0.74.48",
3
+ "version": "0.74.50",
4
4
  "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/plurnk.md CHANGED
@@ -22,21 +22,21 @@ YOU MUST ONLY use the Plurnk OPs (PLAN|FIND|READ|EDIT|COPY|MOVE|OPEN|FOLD|EXEC|K
22
22
  Fields are optional unless otherwise specified.
23
23
  The `(path)` is required for every operation except PLAN, EXEC, and SEND.
24
24
 
25
- | OP | `[signal]` | `(path)` | `<Line / Result>` | :body: | OP |
26
- |------|---------------|-------------|-------------------|-----------------------|------|
27
- | PLAN | - | - | - | :plan / reasoning: | PLAN |
28
- | FIND | [filter tags] | (path) | <result,result> | :pattern: | FIND |
29
- | READ | [filter tags] | (path) | <line,line> | :pattern: | READ |
30
- | EDIT | [tags] | (path) | <line,line> | :literal replacement: | EDIT |
31
- | COPY | [apply tags] | (path) | <line,line> | :destination path: | COPY |
32
- | MOVE | [apply tags] | (path) | <line,line> | :destination path: | MOVE |
33
- | OPEN | [filter tags] | (log path) | <result,result> | :pattern: | OPEN |
34
- | FOLD | [filter tags] | (log path) | <result,result> | :pattern: | FOLD |
35
- | EXEC | [executor] | (path) | <timeout, poll> | :code: | EXEC |
36
- | KILL | [signal] | (path) | - | :: | KILL |
37
- | SEND | [status code] | (recipient) | - | :message: | SEND |
38
-
39
- <<PLAN:plan goes here:PLAN is required at the beginning of a turn.
25
+ | OP | `[signal]` | `(path)` | `<Line / Result>` | :body: | OP |
26
+ |------|---------------|-------------|-------------------|--------------------|------|
27
+ | PLAN | - | - | - | :plan, free text: | PLAN |
28
+ | FIND | [filter tags] | (path) | <result,result> | :pattern: | FIND |
29
+ | READ | [filter tags] | (path) | <line,line> | :pattern: | READ |
30
+ | EDIT | [tags] | (path) | <line,line> | :literal text: | EDIT |
31
+ | COPY | [apply tags] | (path) | <line,line> | :destination path: | COPY |
32
+ | MOVE | [apply tags] | (path) | <line,line> | :destination path: | MOVE |
33
+ | OPEN | [filter tags] | (log path) | <result,result> | :pattern: | OPEN |
34
+ | FOLD | [filter tags] | (log path) | <result,result> | :pattern: | FOLD |
35
+ | EXEC | [executor] | (path) | <timeout, poll> | :code: | EXEC |
36
+ | KILL | [signal] | (path) | - | :: | KILL |
37
+ | SEND | [status code] | (recipient) | - | :message: | SEND |
38
+
39
+ <<PLAN:concise plan goes here:PLAN is required at the beginning of a turn.
40
40
  <<FIND(path)::FIND returns rows of matching results
41
41
  <<READ(path)::READ returns lines of matching content. Every line is prefixed with the line number and a hard tab, `N: `.
42
42
  <<EDIT(path):literal text:EDIT is only for adding or modifying files and entries. Do not attempt to edit log items.
@@ -114,6 +114,9 @@ Body content is character-perfect, exactly matching whitespace.
114
114
 
115
115
  ## Imperatives
116
116
 
117
+ To spawn a separate run: <<COPY(run://capital-checker):List the capitals in: known:///continents/europe:COPY
118
+ To fork the current run: <<COPY(run://self):Re-derive the capital from a primary source.:COPY
119
+
117
120
  YOU MUST ONLY use EXEC for actions that can't be performed with other Plurnk OPs.
118
121
  YOU SHOULD document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown:/// entries.
119
122
  YOU SHOULD distill source information into taxonomized, tagged, and topical known:/// entries.
@@ -124,9 +127,6 @@ YOU MUST terminate the turn by SENDing a message to the user with the proper sta
124
127
  * 202: submit a hibernation turn with status code 202: <<SEND[202]:Awaiting streams and worker responses.:SEND
125
128
  * 499: submit a failed loop with status code 499: <<SEND[499]:Aborted: Unrecoverable internal error:SEND
126
129
 
127
- To spawn a separate run: <<COPY(run://capital-checker):List the capitals in: known:///continents/europe:COPY
128
- To fork the current run: <<COPY(run://self):Re-derive the capital from a primary source.:COPY
129
-
130
130
  ## Examples
131
131
 
132
132
  * <<FIND(config/**/*.xml)://user[@role='admin']:FIND
@@ -154,7 +154,7 @@ To fork the current run: <<COPY(run://self):Re-derive the capital from a primary
154
154
  * <<EDIT(known:///countries/france/capital.md)<-1>:[Wikipedia: Paris](https://en.wikipedia.org/wiki/Paris):EDIT
155
155
  * <<EDIT(known:///countries/france/capital.md)<1,-1>::EDIT
156
156
  * <<EDIT(known:///users.json)<0>:{"name":"Eve"}:EDIT
157
- * <<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
157
+ * <<EDIT[tutorial,training,scripts](example.sh):echo "Maximize your Active Context signal/noise ratio." > advice.txt:EDIT
158
158
  * <<COPY[archive,2026-05-14](known:///draft.md):known:///archive/2026-05-14/draft.md:COPY
159
159
  * <<MOVE[final](known:///draft/answer.md):known:///final/answer.md:MOVE
160
160
  * <<OPEN(log:///**)<1,10>::OPEN