@plurnk/plurnk-grammar 0.76.6 → 0.76.9

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 +17 -17
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-grammar",
3
- "version": "0.76.6",
3
+ "version": "0.76.9",
4
4
  "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/plurnk.md CHANGED
@@ -21,21 +21,21 @@ YOU MUST ONLY use the Plurnk OPs (PLAN|FIND|READ|EDIT|COPY|MOVE|OPEN|FOLD|EXEC|W
21
21
 
22
22
  A `?` marks an optional field, as in the Syntax line; unmarked fields are required.
23
23
 
24
- | OP | `[signal]` | `(path)` | `<scope>` | :body: | OP |
25
- |------|----------------|--------------|--------------------|--------------------|------|
26
- | PLAN | - | - | - | :plan, free text: | PLAN |
27
- | FIND | [tags]? | (path) | <result,result>? | :pattern:? | FIND |
28
- | READ | [tags]? | (path) | <line,line>? | :pattern:? | READ |
29
- | EDIT | [tags]? | (path) | <line,line>? | :literal text:? | EDIT |
30
- | COPY | [tags]? | (path) | <line,line>? | :destination path: | COPY |
31
- | MOVE | [tags]? | (path) | <line,line>? | :destination path: | MOVE |
32
- | OPEN | [tags]? | (log path) | <result,result>? | :pattern:? | OPEN |
33
- | FOLD | [tags]? | (log path) | <result,result>? | :pattern:? | FOLD |
34
- | EXEC | [executor]? | (path)? | <timeout, poll>? | :code:? | EXEC |
35
- | WORK | - | (run://name) | - | :task: | WORK |
36
- | FORK | - | (run://name) | - | :hint:? | FORK |
37
- | KILL | [signal]? | (path) | - | :: | KILL |
38
- | SEND | [submit code]? | (recipient)? | <timeout, poll>? | :message: | SEND |
24
+ | OP | `[signal]` | `(path)` | `<scope>` | :body: | OP |
25
+ |------|----------------|-----------------|--------------------|--------------------|------|
26
+ | PLAN | - | - | - | :plan, free text: | PLAN |
27
+ | FIND | [tags]? | (path) | <result,result>? | :pattern:? | FIND |
28
+ | READ | [tags]? | (path) | <line,line>? | :pattern:? | READ |
29
+ | EDIT | [tags]? | (path) | <line,line>? | :literal text:? | EDIT |
30
+ | COPY | [tags]? | (path) | <line,line>? | :destination path: | COPY |
31
+ | MOVE | [tags]? | (path) | <line,line>? | :destination path: | MOVE |
32
+ | OPEN | [tags]? | (log path) | <result,result>? | :pattern:? | OPEN |
33
+ | FOLD | [tags]? | (log path) | <result,result>? | :pattern:? | FOLD |
34
+ | EXEC | [executor]? | (path)? | <timeout, poll>? | :code:? | EXEC |
35
+ | WORK | - | (run://checker) | - | :task: | WORK |
36
+ | FORK | - | (run://recheck) | - | :hint:? | FORK |
37
+ | KILL | [signal]? | (path) | - | :: | KILL |
38
+ | SEND | [submit code]? | (recipient)? | <timeout, poll>? | :message: | SEND |
39
39
 
40
40
  <<PLAN:concise plan goes here:PLAN is required at the beginning of a turn.
41
41
  <<FIND(path)::FIND returns a JSON array of matches: each object carries its path and per-channel mimetype, tokens, and lines. READ a hit's path to view it.
@@ -79,7 +79,7 @@ Plurnk Service treemaps every file, entry, and item, allowing every pattern filt
79
79
  ### `(path)`
80
80
 
81
81
  * The universal resource path is formatted as a URI for everything but file paths (bare, project-relative).
82
- * `run://name` is the run entity (WORK to spawn a fresh worker, READ to collect its result, FORK to branch the current run, KILL to stop); `run://name/path` is an entry in its workspace.
82
+ * A `run://` path names a run (WORK to spawn a fresh worker, READ to collect its result, FORK to branch the current run, KILL to stop); a path beneath it, like `run://checker/notes.md`, is an entry in its workspace.
83
83
  * Log item paths are nested (`log:///1/2/3` is loop/turn/item) and accept bulk pattern operations (FOLD, OPEN, KILL).
84
84
  * Append `#channel` to select a channel (e.g. `#stdout`, `#stderr`); absent, the scheme's default channel is used.
85
85
  * Path suffix (`.json`, `.md`, `.txt`, etc.) declares mimetype.
@@ -152,7 +152,7 @@ YOU MUST NOT emit free text between operations. Users can only see submission SE
152
152
 
153
153
  YOU MUST start the turn with a concise PLAN.
154
154
  YOU MUST submit the OPs by SENDing either a brief response or a Github-flavored markdown response to the user with the proper submit code.
155
- * 102: submit a continuing turn with submit code 102: <<SEND[102]:FOLDing irrelevant log items and performing retrieval operations.:SEND
155
+ * 102: submit a continuing turn with submit code 102: <<SEND[102]:Performing retrieval operations.:SEND
156
156
  * 202: submit a waiting turn with submit code 202: <<SEND[202]:Awaiting worker results.:SEND
157
157
  * 200: submit a final turn with submit code 200: <<SEND[200]:Retrieval operations received. Tasks successfully performed.:SEND
158
158
  * 499: submit a failed loop with submit code 499: <<SEND[499]:Aborted: Unrecoverable error:SEND