@plurnk/plurnk-grammar 0.62.0 → 0.64.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.
@@ -813,8 +813,8 @@ text-s32 ::= ("A" text-s33 | "<" text-s1 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7FA<]
813
813
  text-s33 ::= ("<" text-s1 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7FN<] text-s0)?
814
814
  text-s34 ::= "F" text-s3 | "R" text-s6 | "E" text-s9 | "C" text-s12 | "M" text-s15 | "O" text-s18 | "S" text-s23 | "K" text-s28 | "P" text-s31 | "<" text-s2 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7FFRECMOSKP<] text-s0
815
815
  text ::= text-s0
816
- status-final ::= "102" | "200" | "202" | "499"
817
- status-mid ::= "10" [0-13-9] | "1" [1-9] [0-9] | "20" [13-9] | "2" [1-9] [0-9] | "4" [0-8] [0-9] | "49" [0-8] | [035-9] [0-9] [0-9]
816
+ status-final ::= "102" | "200" | "202" | "300" | "499"
817
+ status-mid ::= "10" [0-13-9] | "1" [1-9] [0-9] | "20" [13-9] | "2" [1-9] [0-9] | "30" [1-9] | "3" [1-9] [0-9] | "4" [0-8] [0-9] | "49" [0-8] | [05-9] [0-9] [0-9]
818
818
  tags ::= "[" tag tag-rest* "]"
819
819
  tag ::= [A-Za-z0-9_.-]+
820
820
  tag-rest ::= "," tag
package/dist/plurnk.gbnf CHANGED
@@ -778,8 +778,8 @@ plan-statement ::= plan | plan-1 | plan-2 | plan-3 | plan-4 | plan-5 | plan-6 |
778
778
  op-statement ::= find | find-1 | find-2 | find-3 | find-4 | find-5 | find-6 | find-7 | find-8 | find-9 | read | read-1 | read-2 | read-3 | read-4 | read-5 | read-6 | read-7 | read-8 | read-9 | edit | edit-1 | edit-2 | edit-3 | edit-4 | edit-5 | edit-6 | edit-7 | edit-8 | edit-9 | copy | copy-1 | copy-2 | copy-3 | copy-4 | copy-5 | copy-6 | copy-7 | copy-8 | copy-9 | move | move-1 | move-2 | move-3 | move-4 | move-5 | move-6 | move-7 | move-8 | move-9 | open | open-1 | open-2 | open-3 | open-4 | open-5 | open-6 | open-7 | open-8 | open-9 | fold | fold-1 | fold-2 | fold-3 | fold-4 | fold-5 | fold-6 | fold-7 | fold-8 | fold-9 | exec | exec-1 | exec-2 | exec-3 | exec-4 | exec-5 | exec-6 | exec-7 | exec-8 | exec-9 | kill | kill-1 | kill-2 | kill-3 | kill-4 | kill-5 | kill-6 | kill-7 | kill-8 | kill-9 | plan | plan-1 | plan-2 | plan-3 | plan-4 | plan-5 | plan-6 | plan-7 | plan-8 | plan-9
779
779
  send-mid-any ::= send-mid | send-1-mid | send-2-mid | send-3-mid | send-4-mid | send-5-mid | send-6-mid | send-7-mid | send-8-mid | send-9-mid
780
780
  send-final-any ::= send-final | send-1-final | send-2-final | send-3-final | send-4-final | send-5-final | send-6-final | send-7-final | send-8-final | send-9-final
781
- status-final ::= "102" | "200" | "202" | "499"
782
- status-mid ::= "10" [0-13-9] | "1" [1-9] [0-9] | "20" [13-9] | "2" [1-9] [0-9] | "4" [0-8] [0-9] | "49" [0-8] | [035-9] [0-9] [0-9]
781
+ status-final ::= "102" | "200" | "202" | "300" | "499"
782
+ status-mid ::= "10" [0-13-9] | "1" [1-9] [0-9] | "20" [13-9] | "2" [1-9] [0-9] | "30" [1-9] | "3" [1-9] [0-9] | "4" [0-8] [0-9] | "49" [0-8] | [05-9] [0-9] [0-9]
783
783
  tags ::= "[" tag tag-rest* "]"
784
784
  tag ::= [A-Za-z0-9_.-]+
785
785
  tag-rest ::= "," tag
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-grammar",
3
- "version": "0.62.0",
3
+ "version": "0.64.0",
4
4
  "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/plurnk.md CHANGED
@@ -147,7 +147,17 @@ chmod +x ./example.sh
147
147
 
148
148
  <<SEND(run://capital-checker):{"hint":"known entries are your persistent memory"}:SEND
149
149
 
150
- <<SEND[102]:Forking a research run, optimizing log relevance...:SEND
151
- <<SEND[202]:Parked until the capital-checker reports.:SEND
152
- <<SEND[499]:Giving up cannot identify the capital from available sources.:SEND
153
- <<SEND[200]:Paris:SEND
150
+ ## Imperatives
151
+
152
+ YOU MUST ONLY use EXEC commands for actions that can't be performed with Extended HEREDOC Plurnk Operations.
153
+ YOU MUST ONLY communicate with SEND, not with free text between operations.
154
+ YOU MUST document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown entries.
155
+ YOU MUST ONLY populate known entries with source entry information, never with model training.
156
+ YOU SHOULD manage your own context to maximize signal, as irrelevant tokens degrade reasoning.
157
+ YOU SHOULD leverage taxonomic path names, folksonomic tags, and bulk pattern operations to optimize for context relevance.
158
+ YOU MUST use OPEN and FOLD to keep your context budget healthy, optimized, topical, and below the `tokensFree` limit.
159
+ YOU MUST terminate the turn by SENDing a status code containing the results, answer, or a status update: `<<SEND[N]:...:SEND`
160
+ YOU SHOULD terminate a continuing loop with status code 102: <<SEND[102]:Forking a research run, optimizing log relevance...:SEND
161
+ YOU SHOULD terminate a final turn with status code 200: <<SEND[200]:Paris:SEND
162
+ YOU SHOULD terminate a parked/waiting loop with status code 202: <<SEND[202]:Parked until the capital-checker reports.:SEND
163
+ YOU SHOULD terminate a failed/aborted loop with status code 499: <<SEND[499]:Giving up — cannot identify the capital from available sources.:SEND