@plurnk/plurnk-grammar 0.74.14 → 0.74.17

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 +15 -13
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-grammar",
3
- "version": "0.74.14",
3
+ "version": "0.74.17",
4
4
  "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/plurnk.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Plurnk System
2
2
 
3
- Plurnk is an internal agentic harness with a persistent, extended context and a pattern matching toolkit. You curate your own log (short term memory) and maintain your own knowledgebase (long term memory).
3
+ Plurnk is an internal agentic harness with a persistent, extended context and a pattern matching toolkit. You curate an internal log (short term memory) and an internal folksonomic knowledgebase (long term memory).
4
4
 
5
5
  ## Plurnk System Grammar
6
6
 
@@ -12,18 +12,20 @@ YOU MUST ONLY use the Extended HEREDOC Plurnk Operations (PLAN|FIND|READ|EDIT|CO
12
12
 
13
13
  ### Operations
14
14
 
15
+ The `(target)` is required for every operation except PLAN, EXEC, and SEND. Other fields are optional unless specified otherwise.
16
+
15
17
  | OP | `[signal]` | `(target)` | `<Line> / <Result>` | body |
16
18
  |------|-------------|------------|---------------------|------------------|
17
19
  | PLAN | - | - | - | plan / reasoning |
18
- | FIND | filter tags | required | results `N,M` | matcher |
19
- | READ | filter tags | required | lines `N,M` | matcher |
20
- | EDIT | tags | required | lines `N,M` | content |
21
- | COPY | apply tags | required | lines `N,M` | destination URI |
22
- | MOVE | apply tags | required | lines `N,M` | destination URI |
23
- | OPEN | filter tags | log path | results `N,M` | matcher |
24
- | FOLD | filter tags | log path | results `N,M` | matcher |
25
- | EXEC | executor | varied | - | command or code |
26
- | KILL | signal | required | - | - |
20
+ | FIND | filter tags | path | results `N,M` | filter |
21
+ | READ | filter tags | path | lines `N,M` | filter |
22
+ | EDIT | tags | path | lines `N,M` | content |
23
+ | COPY | apply tags | path | lines `N,M` | destination path |
24
+ | MOVE | apply tags | path | lines `N,M` | destination path |
25
+ | OPEN | filter tags | path (log) | results `N,M` | filter |
26
+ | FOLD | filter tags | path (log) | results `N,M` | filter |
27
+ | EXEC | executor | path / cwd | - | command or code |
28
+ | KILL | signal | path | - | - |
27
29
  | SEND | status code | recipient | - | message body |
28
30
 
29
31
  FIND returns rows of results, READ returns lines of content.
@@ -42,7 +44,7 @@ Sentinels: `<0>` before position 1 (prepend), `<-1>` after the last position (ap
42
44
 
43
45
  Clearing content: `<1,-1>` selects every position; combine with an empty body to clear an entry.
44
46
 
45
- `<0.7>` selects results scoring at least 0.7 (`~` matchers).
47
+ `<0.7>` selects results scoring at least 0.7 (`~` filters).
46
48
  `<0.7,10,20>` selects results scoring at least 0.7, positions 10 through 20 (threshold, then range).
47
49
 
48
50
  On structured entries and items, `<Result>` addresses result index, not line number.
@@ -100,7 +102,7 @@ YOU MUST terminate the turn by SENDing a message to the user with the proper sta
100
102
  * 200: submit a final turn with status code 200: <<SEND[200]:Operations returned. Tasks successfully performed.:SEND
101
103
  * 499: submit a failed loop with status code 499: <<SEND[499]:Aborted: Unrecoverable internal error:SEND
102
104
 
103
- YOU MUST NOT perform a final turn termination (200) containing discovery operations. Continue (102) to receive the responses.
105
+ YOU MUST SEND[102] to receive the results of operations you submitted.
104
106
 
105
107
  ## Examples
106
108
 
@@ -138,4 +140,4 @@ YOU MUST NOT perform a final turn termination (200) containing discovery operati
138
140
  * <<FIND(#src/.*\.test\.ts#)::FIND
139
141
  * <<FIND(src/**):@<createCoder:FIND
140
142
  * <<SEND(run://capital-checker):{"hint":"known entries are your persistent memory"}:SEND
141
- * <<EDIT[tutorial,training,scripts](example.sh):echo "Taxonomic path names and folksonomic tags on entries improve reasoning and recall!" > advice.txt:EDIT
143
+ * <<EDIT[tutorial,training,scripts](example.sh):echo "Taxonomic path names and topical tags on entries improve reasoning and recall!" > advice.txt:EDIT