@plurnk/plurnk-grammar 0.74.10 → 0.74.12

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 +12 -3
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-grammar",
3
- "version": "0.74.10",
3
+ "version": "0.74.12",
4
4
  "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/plurnk.md CHANGED
@@ -31,6 +31,7 @@ READ output prefixes every line with line numbers and a hard tab, `N: `. The pre
31
31
  EDIT is only for adding or modifying entries. Do not attempt to edit log items.
32
32
  OPEN expands (`+`) the log item body and costs tokens. FOLD hides (`-`) the log item body and saves tokens. Not all log items have a body (`*`).
33
33
  EXEC produces output stream channels on the next turn that you can then OPEN, FOLD, FIND, READ, or KILL.
34
+ EXEC stream and child run terminations awaken hibernating (202) runs, not terminated (200) runs.
34
35
  KILL deletes entries, erases log items, and kills streams.
35
36
 
36
37
  ### `<Line> / <Result>`
@@ -89,11 +90,19 @@ Body content is character-perfect, exactly matching whitespace.
89
90
  ## Imperatives
90
91
 
91
92
  YOU MUST begin the turn with <<PLAN:plan goes here:PLAN
93
+ YOU MUST NOT emit free text between operations.
92
94
  YOU MUST ONLY use EXEC commands for actions that can't be performed with Extended HEREDOC Plurnk Operations.
95
+ YOU MUST prune irrelevant log items with FOLD or KILL to maximize signal/token and avoid an active context token budget overflow.
93
96
  YOU SHOULD document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown:/// entries.
94
- YOU SHOULD record findings into taxonomized, tagged known:/// entries, preferring source content over recall.
95
- YOU MUST prune irrelevant log items with FOLD or KILL and curate your persistent knowledgebase (known/unknown) to maximize signal/token.
96
- YOU MUST terminate the turn by SENDing a message to the user with the proper status code (102, 200, 202, or 499).
97
+ YOU SHOULD distill source information into taxonomized, tagged, and topical known:/// entries, preferring source content over recall.
98
+
99
+ YOU MUST terminate the turn by SENDing a message to the user with the proper status code: `<<SEND[102]:response to user here:SEND`
100
+ * 102: submit a continuing turn with status code 102: <<SEND[102]:Forking a research run, submitting operations, and optimizing log relevance.:SEND
101
+ * 200: submit a final turn with status code 200: <<SEND[200]:Operations returned. Tasks successfully performed.:SEND
102
+ * 202: submit a hibernation loop with status code 202: <<SEND[202]:Hibernating until the capital-checker reports.:SEND
103
+ * 499: submit a failed loop with status code 499: <<SEND[499]:Aborted: Unrecoverable internal error:SEND
104
+
105
+ YOU MUST NOT perform a final turn termination (200) containing discovery operations. Continue (102) to receive the responses.
97
106
 
98
107
  ## Examples
99
108