@plurnk/plurnk-meta 1.25.0 → 1.27.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.
- package/SPEC.md +10 -6
- package/dist/index.d.ts +14 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -3
- package/dist/index.js.map +1 -1
- package/docs/delegation.md +94 -0
- package/docs/pattern.md +142 -0
- package/docs/worker.md +4 -72
- package/package.json +1 -1
package/SPEC.md
CHANGED
|
@@ -16,6 +16,8 @@ sources into a consuming package would create a second teaching owner.
|
|
|
16
16
|
| `POLICY.md` | Required | First-run default operating policy | Policy bootstrap {§policy-sections} |
|
|
17
17
|
| `recap.md` | Required | Optional default operational Recap | Per-packet user-slot footer {§recap} |
|
|
18
18
|
| `docs/worker.md` | Required | Deep reference prose for the reserved worker scheme | Pull-doc materialization {§schemes-directory} |
|
|
19
|
+
| `docs/delegation.md` | Required | Worker delegation, lifecycle, and messaging | Pull-doc materialization with the worker scheme |
|
|
20
|
+
| `docs/pattern.md` | Required | Operation-neutral pattern selection and literal source editing | Pull-doc materialization independent of schemes |
|
|
19
21
|
| `skills/plurnk/SKILL.md` | Required | Standard Plurnk skill entry and chapter directory | Service-provided skill {§plurnk-skill} |
|
|
20
22
|
|
|
21
23
|
Every teaching source, and every package's `docs/*.md`, is written to
|
|
@@ -31,12 +33,14 @@ its one authored source for later use. Consumers resolve the exported membership
|
|
|
31
33
|
exactly: they do not scan `docs/`, infer new members from filenames, or treat a
|
|
32
34
|
missing required source as empty teaching.
|
|
33
35
|
|
|
34
|
-
A file in `docs/` does not declare a capability.
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
36
|
+
A file in `docs/` does not declare a capability. Each exported document declares
|
|
37
|
+
its source and an optional owning scheme. Scheme-bound references follow that
|
|
38
|
+
scheme's visibility and capability admission; language references are independent
|
|
39
|
+
of scheme registration. A basename is a document identity, not an invented scheme.
|
|
40
|
+
Plugin documentation remains owned by its manifest: an absent `documentation`
|
|
41
|
+
contributes no pull doc; a present field is the fallback when meta owns no
|
|
42
|
+
document of that name. Document exclusions apply to the document and its owning
|
|
43
|
+
scheme, when present.
|
|
40
44
|
|
|
41
45
|
## §skills-installation-boundary Skill composition and installation
|
|
42
46
|
|
package/dist/index.d.ts
CHANGED
|
@@ -31,11 +31,22 @@ export declare const TEACHING_CORPUS: Readonly<{
|
|
|
31
31
|
readonly policy: "POLICY.md";
|
|
32
32
|
readonly recap: "recap.md";
|
|
33
33
|
readonly skill: "skills/plurnk/SKILL.md";
|
|
34
|
-
readonly
|
|
35
|
-
readonly worker:
|
|
34
|
+
readonly docs: Readonly<{
|
|
35
|
+
readonly worker: Readonly<{
|
|
36
|
+
source: "docs/worker.md";
|
|
37
|
+
scheme: "worker";
|
|
38
|
+
}>;
|
|
39
|
+
readonly delegation: Readonly<{
|
|
40
|
+
source: "docs/delegation.md";
|
|
41
|
+
scheme: "worker";
|
|
42
|
+
}>;
|
|
43
|
+
readonly pattern: Readonly<{
|
|
44
|
+
source: "docs/pattern.md";
|
|
45
|
+
scheme: null;
|
|
46
|
+
}>;
|
|
36
47
|
}>;
|
|
37
48
|
}>;
|
|
38
|
-
export type TeachingCorpusSource = typeof TEACHING_CORPUS.policy | typeof TEACHING_CORPUS.recap | typeof TEACHING_CORPUS.skill | (typeof TEACHING_CORPUS.
|
|
49
|
+
export type TeachingCorpusSource = typeof TEACHING_CORPUS.policy | typeof TEACHING_CORPUS.recap | typeof TEACHING_CORPUS.skill | (typeof TEACHING_CORPUS.docs)[keyof typeof TEACHING_CORPUS.docs]["source"];
|
|
39
50
|
export default class Meta {
|
|
40
51
|
#private;
|
|
41
52
|
static declaresKind(manifest: unknown, kind: PluginKind): boolean;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,QAAA,MAAM,YAAY,YAAI,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,CAAU,CAAC;AACxG,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAGrD,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAID,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACpC,YAAY,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;CACrG;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -35,8 +35,10 @@ export { default as ConfigurationError } from "./ConfigurationError.js";
|
|
|
35
35
|
export { default as ResourceEnvironment } from "./ResourceEnvironment.js";
|
|
36
36
|
export { default as ErrorDetail } from "./ErrorDetail.js";
|
|
37
37
|
const PLUGIN_KINDS = ["exec", "mimetype", "provider", "scheme", "http-materializer", "module"];
|
|
38
|
-
const
|
|
39
|
-
worker: "docs/worker.md",
|
|
38
|
+
const REFERENCE_TEACHING = Object.freeze({
|
|
39
|
+
worker: Object.freeze({ source: "docs/worker.md", scheme: "worker" }),
|
|
40
|
+
delegation: Object.freeze({ source: "docs/delegation.md", scheme: "worker" }),
|
|
41
|
+
pattern: Object.freeze({ source: "docs/pattern.md", scheme: null }),
|
|
40
42
|
});
|
|
41
43
|
// {§teaching-corpus} — the authored package membership is one exported fact;
|
|
42
44
|
// consumers decide when and where each required source is projected.
|
|
@@ -45,7 +47,7 @@ export const TEACHING_CORPUS = Object.freeze({
|
|
|
45
47
|
policy: "POLICY.md",
|
|
46
48
|
recap: "recap.md",
|
|
47
49
|
skill: "skills/plurnk/SKILL.md",
|
|
48
|
-
|
|
50
|
+
docs: REFERENCE_TEACHING,
|
|
49
51
|
});
|
|
50
52
|
const TRUSTED_ONLY = "PLURNK_PLUGINS_TRUSTED_ONLY";
|
|
51
53
|
const RESERVED_ATTRIBUTION_PREFIX = "@plurnk/";
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# Delegation and messages
|
|
2
|
+
|
|
3
|
+
## Summary
|
|
4
|
+
|
|
5
|
+
WORK, FORK, SEND, WAIT, and KILL coordinate workers and their obligations.
|
|
6
|
+
|
|
7
|
+
## Delegation
|
|
8
|
+
|
|
9
|
+
WORK starts a fresh log with the task body as its prompt; FORK copies your
|
|
10
|
+
history and named scratch into the new name, then diverges. Embedded addresses
|
|
11
|
+
are preserved verbatim. Both share the workspace. An omitted address allocates
|
|
12
|
+
a short worker name, reported in the receipt; an explicit name cannot replace
|
|
13
|
+
an existing worker, even after it finishes. Names match
|
|
14
|
+
`[A-Za-z0-9][A-Za-z0-9_-]{0,62}` and are case-sensitive. SEND to an existing
|
|
15
|
+
worker gives it a follow-up task.
|
|
16
|
+
|
|
17
|
+
```WORK (worker://child) [{"env":{"LANG":"C.UTF-8"}}] <!-- fresh log -->
|
|
18
|
+
The child's complete task goes here.
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
`env` occupies the header's `[metadata]` slot after the worker address; the
|
|
22
|
+
body is the child's task, not a JSON options object. On WORK and FORK these
|
|
23
|
+
values override the child's inherited environment (`env.md`).
|
|
24
|
+
|
|
25
|
+
```FORK (worker://exampleWorkerName) <!-- a child that begins with your history -->
|
|
26
|
+
The child's task, continuing from what you already know.
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
```SEND (worker://child) <!-- follow-up to the existing worker -->
|
|
30
|
+
The follow-up task or additional information goes here.
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Parents observe a direct child's mutations, messages, executor invocations, and
|
|
34
|
+
worker launches, including failed actions, as rows in their own log.
|
|
35
|
+
Exploration and context curation (NOTE, READ, FIND, BARE, WAIT, and log KILL)
|
|
36
|
+
stay with the child, including READs of executor output. These observations
|
|
37
|
+
never wake the parent; replies and child conclusions retain their ordinary
|
|
38
|
+
delivery and wake behavior.
|
|
39
|
+
|
|
40
|
+
## Lifecycle
|
|
41
|
+
|
|
42
|
+
Ordinary operations keep the loop working while children run; WAIT joins their
|
|
43
|
+
activity. With live work (a child or an open stream) the loop parks and wakes
|
|
44
|
+
when that work settles, when a message arrives, or when the wait duration expires;
|
|
45
|
+
without live work it continues at once. `WAIT <600>` waits at most ten minutes;
|
|
46
|
+
bare WAIT uses the configured default. Expiry resumes inspection without
|
|
47
|
+
cancelling work. Zero continues immediately. Invalid durations are ignored with
|
|
48
|
+
a warning. Several WAITs are one park with the earliest bound. An optional
|
|
49
|
+
path is a label, not a selected wake source.
|
|
50
|
+
|
|
51
|
+
```WAIT
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
A wake ends the suspension, not its held work; a further WAIT waits again.
|
|
55
|
+
Waking retains the loop's messages, turn allowance, and remaining execution
|
|
56
|
+
time; parked time does not consume execution time. A turn containing only a
|
|
57
|
+
parameterless KILL requests completion: its body answers the Open Messages, or
|
|
58
|
+
is empty when an already-delivered answer stands. While live work remains, that
|
|
59
|
+
KILL joins it without cancelling it and delivers no final answer.
|
|
60
|
+
|
|
61
|
+
Each child task's conclusion wakes its waiting parent and arrives once, as an
|
|
62
|
+
`_plurnk` READ of `ops://exampleWorkerName/1` carrying what the child said: the
|
|
63
|
+
execution outcome, not another message, and not delivered again as a reply. A
|
|
64
|
+
failure retains its status and Problem. READ that address with a scope to
|
|
65
|
+
inspect more of the exact result, even after the child starts another task.
|
|
66
|
+
Bare `READ (worker://exampleWorkerName)` collects the current result instead, naming its
|
|
67
|
+
exact source in `resource`; while the child is running it returns `425`. A
|
|
68
|
+
result does not imply that every task in that worker has finished.
|
|
69
|
+
|
|
70
|
+
`KILL (worker://<name>)` cancels that worker and its descendants, including
|
|
71
|
+
queued work and unread messages. History remains readable; a later SEND can
|
|
72
|
+
start new work.
|
|
73
|
+
|
|
74
|
+
```KILL (worker://child) <!-- cancel this worker's activity -->
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Messages
|
|
78
|
+
|
|
79
|
+
Open Messages names unanswered messages; an arrival receipt's `resource` links
|
|
80
|
+
to the same source. SEND to that address answers that message. A targetless
|
|
81
|
+
SEND answers your observed Open Messages, or your loop's original message when
|
|
82
|
+
none remain open; a concluding parameterless KILL uses the same reply routing
|
|
83
|
+
for its body. An empty targetless SEND delivers nothing. SEND to a worker
|
|
84
|
+
control address gives it new work instead. Curation of a message's log
|
|
85
|
+
occurrences never deletes the source or changes whether it was answered.
|
|
86
|
+
Another worker may answer it; the assigned worker and original sender receive
|
|
87
|
+
that reply without a new request.
|
|
88
|
+
|
|
89
|
+
SEND accepts `[{"attachments":["report.pdf","worker:///example.md"]}]`:
|
|
90
|
+
send-time copies delivered through ordinary resource links, not native media
|
|
91
|
+
injection; the recipient READs what it needs, and a missing source fails before
|
|
92
|
+
delivery. The same option works on a targetless reply. A SEND takes no scope;
|
|
93
|
+
delivery later or on a cadence is the `schedule` family's, arriving as an
|
|
94
|
+
ordinary message from `schedule://<alias>`.
|
package/docs/pattern.md
ADDED
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# Patterns
|
|
2
|
+
|
|
3
|
+
## Summary
|
|
4
|
+
|
|
5
|
+
Select source text consistently with literal, glob, regex, full-text, structural, and graph patterns.
|
|
6
|
+
|
|
7
|
+
A path chooses resources; a pattern selects within the addressed channel.
|
|
8
|
+
The selection has the same meaning across operations. FIND reports matches;
|
|
9
|
+
READ shows their source lines and locations; EDIT replaces each selected span
|
|
10
|
+
with its literal body. COPY transfers selected text; MOVE transfers then removes
|
|
11
|
+
it; textual KILL removes it. Surrounding text displayed by READ is not part of
|
|
12
|
+
the match. Multiple fragments are concatenated in source order without added
|
|
13
|
+
separators.
|
|
14
|
+
|
|
15
|
+
## What a pattern selects
|
|
16
|
+
|
|
17
|
+
| Pattern | Selection |
|
|
18
|
+
| --- | --- |
|
|
19
|
+
| `retry` | Each literal substring occurrence |
|
|
20
|
+
| `/\bretry\b/i` | Each complete ECMAScript regex match |
|
|
21
|
+
| `*retry*` | Each whole line matching the glob |
|
|
22
|
+
| `~retry` | FTS5 token occurrences; the query determines which resources match |
|
|
23
|
+
| `//item` | Item elements |
|
|
24
|
+
| `//item/text()` | Their direct text nodes |
|
|
25
|
+
| `//item/@id` | The complete source attribute, not only its value |
|
|
26
|
+
| `$.host` | The JSON member's serialized value, including string quotes |
|
|
27
|
+
| `&connect` | Definitions of `connect` |
|
|
28
|
+
| `&<connect` | References to `connect` |
|
|
29
|
+
| `&>connect` | Definitions of names referenced by `connect` |
|
|
30
|
+
|
|
31
|
+
Graph selections use the language handler's extracted definitions and
|
|
32
|
+
references, not compiler-resolved bindings. Replacing references is literal
|
|
33
|
+
source editing, not a semantic rename.
|
|
34
|
+
|
|
35
|
+
## Same selection, different operations
|
|
36
|
+
|
|
37
|
+
For source `const first = connect(); const second = connect();`:
|
|
38
|
+
|
|
39
|
+
| Operation | Result |
|
|
40
|
+
| --- | --- |
|
|
41
|
+
| `FIND (client.js) /connect/` | Two locations: `<1,15,1,22>` and `<1,41,1,48>` |
|
|
42
|
+
| `READ (client.js) /connect/` | The source line once, with both match locations |
|
|
43
|
+
| `EDIT (client.js) /connect/`, body `open` | `const first = open(); const second = open();` |
|
|
44
|
+
| `EDIT (client.js) <1,15,1,22> /connect/`, body `open` | Only the first occurrence changes |
|
|
45
|
+
|
|
46
|
+
A source scope narrows mutation and transfer selections to complete matches inside it.
|
|
47
|
+
A READ preview limits what is shown, not what a later pattern selects.
|
|
48
|
+
Coordinates always refer to the addressed source channel, not receipt
|
|
49
|
+
decorations or another channel's rendered text.
|
|
50
|
+
|
|
51
|
+
Regex anchors `^` and `$` address line boundaries; a match may span lines.
|
|
52
|
+
EDIT's body is literal replacement text, not regex substitution syntax.
|
|
53
|
+
|
|
54
|
+
## Pattern and metadata slots
|
|
55
|
+
|
|
56
|
+
The bare pattern selects text. The header's optional `[metadata]` slot carries
|
|
57
|
+
named options; first-party operations read it as a JSON array of option objects.
|
|
58
|
+
It follows the path and optional scope, before a bare pattern or aside. The body
|
|
59
|
+
remains the operation's input, not its options. Other option names belong to the
|
|
60
|
+
addressed scheme or executor; `env.md` describes the `env` option.
|
|
61
|
+
|
|
62
|
+
`READ (client.js) /connect/` and
|
|
63
|
+
`READ (client.js) [{"pattern":"/connect/"}]` select identically. The `pattern`
|
|
64
|
+
option carries a matcher that would collide with header syntax, such as literal
|
|
65
|
+
text starting with `[`. EDIT also uses it for unprefixed literal/glob matchers.
|
|
66
|
+
COPY and MOVE use it to bind a pattern to the source or destination operand;
|
|
67
|
+
this example selects from the source and creates `names.txt`:
|
|
68
|
+
|
|
69
|
+
```COPY (client.js) [{"pattern":"/connect/"}] (names.txt)
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
The copied text is `connectconnect`; surrounding calls and punctuation are not selected.
|
|
73
|
+
|
|
74
|
+
## Elements and text
|
|
75
|
+
|
|
76
|
+
For source `<root><item>A</item><other>B</other></root>`:
|
|
77
|
+
|
|
78
|
+
```EDIT (items.xml) //item/text()
|
|
79
|
+
C
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
produces `<root><item>C</item><other>B</other></root>`.
|
|
83
|
+
|
|
84
|
+
```EDIT (items.xml) //item
|
|
85
|
+
<label>C</label>
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
produces `<root><label>C</label><other>B</other></root>`. `label` is an ordinary
|
|
89
|
+
XML element name in the replacement text, not Plurnk syntax.
|
|
90
|
+
|
|
91
|
+
An empty body removes the selected source text. In mixed content
|
|
92
|
+
`<item>A<b>B</b>C</item>`, `//item/text()` selects `A` and `C`, not the nested
|
|
93
|
+
`B`; replacement body `X` produces `<item>X<b>B</b>X</item>`.
|
|
94
|
+
|
|
95
|
+
For `<item id="old"/>`, `//item/@id` selects `id="old"`. EDIT body
|
|
96
|
+
`id="new"` replaces that attribute; KILL removes it. Entity spellings and
|
|
97
|
+
quotes are preserved by COPY: text `A & B` copies as `A & B`.
|
|
98
|
+
|
|
99
|
+
## JSON values
|
|
100
|
+
|
|
101
|
+
For source `{"host":"old","port":80}`:
|
|
102
|
+
|
|
103
|
+
```EDIT (settings.json) $.host
|
|
104
|
+
"new"
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
produces `{"host":"new","port":80}`. The selected value includes its original
|
|
108
|
+
quotes and escapes, not the property name or colon. The replacement body is
|
|
109
|
+
source text: EDIT does not quote, escape, or serialize it for you.
|
|
110
|
+
|
|
111
|
+
Body `new` would instead produce `{"host":new,"port":80}`, which is invalid
|
|
112
|
+
JSON. Body `null` assigns JSON null; body `"null"` assigns the string `null`.
|
|
113
|
+
Selecting only the substring with `/old/` lets body `new` retain the existing
|
|
114
|
+
quotes. The quotes follow what was selected, not a separate EDIT requirement.
|
|
115
|
+
|
|
116
|
+
Likewise, `$[0]` selects an array element's value, not an adjacent comma.
|
|
117
|
+
Replacing the containing array can remove an element structurally;
|
|
118
|
+
empty-body replacement only removes the selected text.
|
|
119
|
+
|
|
120
|
+
## Bytes
|
|
121
|
+
|
|
122
|
+
On a native binary channel, literal, regex, and glob patterns match bytes
|
|
123
|
+
one character per byte; regex `\xNN` matches a byte value. READ shows hex,
|
|
124
|
+
one byte per line. COPY and MOVE transfer the selected bytes unchanged;
|
|
125
|
+
source and destination scopes use byte positions. Text EDIT bodies do not
|
|
126
|
+
author native bytes. Structural and indexed text dialects require a text channel.
|
|
127
|
+
|
|
128
|
+
## Source coordinates
|
|
129
|
+
|
|
130
|
+
Exact match locations are `region`; `enclosingRegion` is display context only.
|
|
131
|
+
A computed value or a synthesized node can have a locator without a source
|
|
132
|
+
span. FIND reports it; READ needs source or enclosing coordinates to show text.
|
|
133
|
+
Mutation and transfer require exact source coordinates and do not substitute
|
|
134
|
+
an ancestor's text. Scoped READ of a reported exact region retrieves that
|
|
135
|
+
fragment.
|
|
136
|
+
|
|
137
|
+
## Dialect references
|
|
138
|
+
|
|
139
|
+
- [ECMAScript regular expressions](https://tc39.es/ecma262/#sec-regexp-regular-expression-objects)
|
|
140
|
+
- [XPath 1.0](https://www.w3.org/TR/1999/REC-xpath-19991116/)
|
|
141
|
+
- [JSONPath, RFC 9535](https://www.rfc-editor.org/rfc/rfc9535)
|
|
142
|
+
- [SQLite FTS5 queries](https://www.sqlite.org/fts5.html#full_text_query_syntax)
|
package/docs/worker.md
CHANGED
|
@@ -40,73 +40,8 @@ new arrival.
|
|
|
40
40
|
|
|
41
41
|
## Delegation
|
|
42
42
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
are preserved verbatim. Both share the workspace. An omitted address allocates
|
|
46
|
-
a short worker name, reported in the receipt; an explicit name cannot replace
|
|
47
|
-
an existing worker, even after it finishes. Names match
|
|
48
|
-
`[A-Za-z0-9][A-Za-z0-9_-]{0,62}` and are case-sensitive. SEND to an existing
|
|
49
|
-
worker gives it a follow-up task. `[{"env": {...}}]` on WORK or FORK is the
|
|
50
|
-
child's starting environment (`env.md`).
|
|
51
|
-
|
|
52
|
-
```FORK (worker://exampleWorkerName) <!-- a sibling that begins with your history -->
|
|
53
|
-
The child's task, continuing from what you already know.
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
Parents observe a direct child's mutations, messages, executor invocations, and
|
|
57
|
-
worker launches, including failed actions, as rows in their own log.
|
|
58
|
-
Exploration and context curation (NOTE, READ, FIND, BARE, WAIT, and log KILL)
|
|
59
|
-
stay with the child, including READs of executor output. These observations
|
|
60
|
-
never wake the parent; replies and child conclusions retain their ordinary
|
|
61
|
-
delivery and wake behavior.
|
|
62
|
-
|
|
63
|
-
## Lifecycle
|
|
64
|
-
|
|
65
|
-
Ordinary operations keep the loop working while children run; WAIT joins their
|
|
66
|
-
activity. With live work (a child or an open stream) the loop parks and wakes
|
|
67
|
-
when that work settles, when a message arrives, or on an open stream's
|
|
68
|
-
observation cadence; without live work it continues at once. Several WAITs in
|
|
69
|
-
one turn are one park, and what a WAIT names is its label; scope and metadata
|
|
70
|
-
decorations are ignored.
|
|
71
|
-
|
|
72
|
-
A wake ends the suspension, not its held work; a further WAIT waits again.
|
|
73
|
-
Waking retains the loop's messages, turn allowance, and remaining execution
|
|
74
|
-
time; parked time does not consume execution time. A turn containing only a
|
|
75
|
-
parameterless KILL requests completion: its body answers the Open Messages, or
|
|
76
|
-
is empty when an already-delivered answer stands. While live work remains, that
|
|
77
|
-
KILL joins it without cancelling it and delivers no final answer.
|
|
78
|
-
|
|
79
|
-
Each child task's conclusion wakes its waiting parent and arrives once, as an
|
|
80
|
-
`_plurnk` READ of `ops://exampleWorkerName/1` carrying what the child said: the
|
|
81
|
-
execution outcome, not another message, and not delivered again as a reply. A
|
|
82
|
-
failure retains its status and Problem. READ that address with a scope to
|
|
83
|
-
inspect more of the exact result, even after the child starts another task.
|
|
84
|
-
Bare `READ (worker://exampleWorkerName)` collects the current result instead, naming its
|
|
85
|
-
exact source in `resource`; while the child is running it returns `425`. A
|
|
86
|
-
result does not imply that every task in that worker has finished.
|
|
87
|
-
|
|
88
|
-
`KILL (worker://<name>)` cancels that worker and its descendants, including
|
|
89
|
-
queued work and unread messages. History remains readable; a later SEND can
|
|
90
|
-
start new work.
|
|
91
|
-
|
|
92
|
-
## Messages
|
|
93
|
-
|
|
94
|
-
Open Messages names unanswered messages; an arrival receipt's `resource` links
|
|
95
|
-
to the same source. SEND to that address answers that message. A targetless
|
|
96
|
-
SEND answers your observed Open Messages, or your loop's original message when
|
|
97
|
-
none remain open; a concluding parameterless KILL uses the same reply routing
|
|
98
|
-
for its body. An empty targetless SEND delivers nothing. SEND to a worker
|
|
99
|
-
control address gives it new work instead. Curation of a message's log
|
|
100
|
-
occurrences never deletes the source or changes whether it was answered.
|
|
101
|
-
Another worker may answer it; the assigned worker and original sender receive
|
|
102
|
-
that reply without a new request.
|
|
103
|
-
|
|
104
|
-
SEND accepts `[{"attachments":["report.pdf","worker:///example.md"]}]`:
|
|
105
|
-
send-time copies delivered through ordinary resource links, not native media
|
|
106
|
-
injection; the recipient READs what it needs, and a missing source fails before
|
|
107
|
-
delivery. The same option works on a targetless reply. A SEND takes no scope;
|
|
108
|
-
delivery later or on a cadence is the `schedule` family's, arriving as an
|
|
109
|
-
ordinary message from `schedule://<alias>`.
|
|
43
|
+
[Delegation and messages](worker:///_plurnk/plurnk/delegation.md) covers worker
|
|
44
|
+
creation, child observations, waiting, completion, and reply routing.
|
|
110
45
|
|
|
111
46
|
## BARE inference
|
|
112
47
|
|
|
@@ -141,8 +76,5 @@ original evidence. The current turn's reasoning exists when its OPs execute, so
|
|
|
141
76
|
`READ (reasoning://exampleWorkerName/1/3) <1,-1>` from `worker://exampleWorkerName` on loop 1,
|
|
142
77
|
turn 3 retains it; a turn that produced no reasoning reads empty, and a turn
|
|
143
78
|
that has not happened returns a missing-source result. READ never requests
|
|
144
|
-
inference.
|
|
145
|
-
|
|
146
|
-
reasoned operations remain data. Notes are ordinary log items whose read-only
|
|
147
|
-
sources stay searchable (`FIND (note://exampleWorkerName/**) /parser/`) and READable
|
|
148
|
-
after curation or a FORK.
|
|
79
|
+
inference. Notes are ordinary log items whose read-only sources stay searchable
|
|
80
|
+
(`FIND (note://exampleWorkerName/**) /parser/`) and READable after curation or a FORK.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-meta",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.27.0",
|
|
4
4
|
"description": "Plugin discovery and trust primitives shared by plurnk plugin families, and the teaching material the plurnk service gives models: policy, Recap, the plurnk skill and scheme references.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"plurnk",
|