@plurnk/plurnk-grammar 0.75.5 → 0.76.0

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,qDAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACR,aAAa,EACb,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,aAAa,EACb,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,aAAa,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,QAAS,MAAM,qDAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACR,aAAa,EACb,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,aAAa,EACb,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,aAAa,GAChB,MAAM,YAAY,CAAC"}

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAS1D,eAAO,MAAM,UAAU,mHAEb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAInD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAIvC,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,eAAe,IACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,CAAC,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,eAAe,IAAI;IAC3C,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAS1D,eAAO,MAAM,UAAU,YACnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAChG,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAInD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAIvC,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,eAAe,IACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,CAAC,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,eAAe,IAAI;IAC3C,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-grammar",
-  "version": "0.75.5",
+  "version": "0.76.0",
   "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
   "type": "module",
   "license": "MIT",
@@ -57,6 +57,6 @@
     "@types/node": "^26.1.1",
     "antlr-ng": "^1.0.10",
     "json-schema-to-typescript": "^15.0.4",
-    "typescript": "^6.0.3"
+    "typescript": "^7.0.2"
   }
 }

package/plurnk.md

@@ -34,7 +34,7 @@ The `(path)` is required for every operation except PLAN, EXEC, and SEND.
 | FOLD | [filter tags] | (log path)  | <result,result>   | :pattern:          | FOLD |
 | EXEC | [executor]    | (path)      | <timeout, poll>   | :code:             | EXEC |
 | KILL | [signal]      | (path)      | -                 | ::                 | KILL |
-| SEND | [submit code] | (recipient) | -                 | :message:          | SEND |
+| SEND | [submit code] | (recipient) | <timeout, poll>   | :message:          | SEND |
 
 <<PLAN:concise plan goes here:PLAN is required at the beginning of a turn.
 <<FIND(path)::FIND returns rows of matching results
@@ -46,8 +46,7 @@ The `(path)` is required for every operation except PLAN, EXEC, and SEND.
 <<EXEC::EXEC produces output stream channels on the next turn that you can then FIND, READ, or KILL.
 <<KILL(path)::KILL deletes files and entries, erases log items, and kills streams.
 <<SEND[102]:doing:SEND to submit OPs, emit streams, or launch worker runs.
-<<SEND[102]<60>:polling:SEND parks the run up to 60 seconds; arriving results, worker replies, and user messages wake it early.
-<<SEND[102]<-1>:standing by:SEND parks indefinitely until something arrives.
+<<SEND[202]:standing by:SEND waits on your live workers, streams, and results; their arrival wakes it.
 <<SEND[200]:done:SEND to terminate a completed run only if all OPs, streams, and runs have already returned.
 
 ### Suffix
@@ -78,7 +77,8 @@ Plurnk Service treemaps every file, entry, and item, allowing every pattern filt
 ### `(path)`
 
 * The universal resource path is formatted as a URI for everything but file paths (bare, project-relative).
-* `run://name` is the run entity (WORK to spawn a fresh worker, FORK to branch the current run, KILL to stop); `run://name/path` is an entry in its workspace.
+* `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.
+* Log item paths are nested (`log:///1/2/3` is loop/turn/item) and accept bulk pattern operations (FOLD, OPEN, KILL).
 * Append `#channel` to select a channel (e.g. `#stdout`, `#stderr`); absent, the scheme's default channel is used.
 * Path suffix (`.json`, `.md`, `.txt`, etc.) declares mimetype.
 * Percent-encode reserved characters in paths: `)`→`%29`, `<`→`%3C`.
@@ -119,6 +119,7 @@ Body content is character-perfect, exactly matching whitespace.
 ## Delegation
 
 To spawn a new WORKer run: <<WORK(run://capital-checker):Find the capital of France from a primary source:WORK
+To COLLECT a worker's result: <<READ(run://capital-checker)::READ
 To FORK the current run: <<FORK(run://recheck):Re-derive the capital from a primary source:FORK
 To SEND a run a message: <<SEND(run://recheck):Also, what's the capital of Germany?:SEND
 To KILL another run: <<KILL(run://recheck)::KILL
@@ -129,7 +130,7 @@ YOU SHOULD document all relevant questions and uncertainties into taxonomized, t
 YOU SHOULD distill source information into taxonomized, tagged, and topical known:/// entries.
 
 YOU MUST ONLY use EXEC for actions that can't be performed with other Plurnk OPs.
-YOU MUST KILL leftover worker runs and streams, or await them with SEND[102]<seconds>, before SEND[200] final turn.
+YOU MUST KILL leftover worker runs and streams, or await them with SEND[202], before SEND[200] final turn.
 YOU MUST avoid and recover from Budget Overflow errors by FOLDing or KILLing big or irrelevant log items to save tokens.
 YOU MUST NOT share internal knowledgebase paths. Users can't access them.
 YOU MUST NOT emit free text between operations. Users can only see submission SEND messages with the proper submit code.
@@ -137,6 +138,7 @@ YOU MUST NOT emit free text between operations. Users can only see submission SE
 YOU MUST start the turn with a concise PLAN.
 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.
 * 102: submit a continuing turn with submit code 102: <<SEND[102]:FOLDing irrelevant log items and performing retrieval operations.:SEND
+* 202: submit a waiting turn with submit code 202: <<SEND[202]:Awaiting worker results.:SEND
 * 200: submit a final turn with submit code 200: <<SEND[200]:Retrieval operations received. Tasks successfully performed.:SEND
 * 499: submit a failed loop with submit code 499: <<SEND[499]:Aborted: Unrecoverable error:SEND
 
@@ -173,7 +175,7 @@ YOU MUST submit the OPs by SENDing either a brief response or a Github-flavored
 * <<OPEN(log:///**)<1,10>::OPEN
 * <<FOLD(log:///**)<101,200>::FOLD
 * <<SEND(run://capital-checker):{"hint":"known entries are your persistent memory"}:SEND
-* <<SEND[102]<300>:Parked awaiting worker capital-checker; wake on reply or in 300s.:SEND
+* <<SEND[202]:Awaiting worker capital-checker.:SEND
 * <<KILL(known:///draft.md)::KILL
 * <<KILL(obsolete/file.md)::KILL
 * <<KILL(sh:///3/1/2)::KILL