@plurnk/plurnk-execs 1.8.0 → 1.9.1
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/README.md +1 -1
- package/SPEC.md +9 -0
- package/dist/BaseExecutor.d.ts +2 -1
- package/dist/BaseExecutor.d.ts.map +1 -1
- package/dist/BaseExecutor.js +7 -0
- package/dist/BaseExecutor.js.map +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -52,7 +52,7 @@ tag independently. A name uses lowercase URI-scheme syntax
|
|
|
52
52
|
`[a-z][a-z0-9+.-]*`; `only` is reserved by runtime policy. `summary` is the
|
|
53
53
|
one-line capability description. `invocation` defines the body and optional
|
|
54
54
|
target buckets plus one canonical example used for dispatch enforcement and the
|
|
55
|
-
generated `worker
|
|
55
|
+
generated `worker://~/_plurnk/tools/` document. A `docs/<tag>.md` file supplies
|
|
56
56
|
supplemental detail. See {§executor-runtime-declaration}.
|
|
57
57
|
|
|
58
58
|
### Implement the executor
|
package/SPEC.md
CHANGED
|
@@ -68,6 +68,15 @@ interface ExecArgs {
|
|
|
68
68
|
): Promise<string>;
|
|
69
69
|
}
|
|
70
70
|
|
|
71
|
+
`ExecArgs` deliberately carries **no Worker identity**: an executor is a
|
|
72
|
+
worker-agnostic capability, and `run` may assume nothing about which Worker,
|
|
73
|
+
Loop, or workspace invoked it beyond the arguments given. A runtime whose
|
|
74
|
+
behavior depends on a Worker — an attached MCP server, a Worker Functionality
|
|
75
|
+
manager — is published per Worker by its owning module, closing over that
|
|
76
|
+
identity at publication ({§functionality-model-projection} in the core
|
|
77
|
+
specification; the MCP host is the precedent). Consumers must not smuggle
|
|
78
|
+
identity through `env` or `body` conventions.
|
|
79
|
+
|
|
71
80
|
interface RuntimeAvailability {
|
|
72
81
|
available: boolean;
|
|
73
82
|
detail?: string;
|
package/dist/BaseExecutor.d.ts
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import type { SchemeHandler, SchemeManifest } from "@plurnk/plurnk-schemes";
|
|
1
|
+
import type { SchemeFlagAffinity, SchemeHandler, SchemeManifest } from "@plurnk/plurnk-schemes";
|
|
2
2
|
import type { ChannelDecl, Effect, ExecArgs, ExecResult, ExecutorMetadata, RuntimeAvailability } from "./types.ts";
|
|
3
3
|
export default abstract class BaseExecutor implements SchemeHandler {
|
|
4
4
|
readonly runtime: string;
|
|
5
5
|
readonly glyph: string;
|
|
6
6
|
constructor({ runtime, glyph }: ExecutorMetadata);
|
|
7
7
|
get manifest(): SchemeManifest;
|
|
8
|
+
get flags(): SchemeFlagAffinity | undefined;
|
|
8
9
|
get defaultChannel(): string;
|
|
9
10
|
abstract get channels(): Readonly<Record<string, ChannelDecl>>;
|
|
10
11
|
abstract run(args: ExecArgs): Promise<ExecResult>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"BaseExecutor.d.ts","sourceRoot":"","sources":["../src/BaseExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"BaseExecutor.d.ts","sourceRoot":"","sources":["../src/BaseExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAWnH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,YAAa,YAAW,aAAa;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,gBAAgB,EAG/C;IAaD,IAAI,QAAQ,IAAI,cAAc,CAU7B;IAKD,IAAI,KAAK,IAAI,kBAAkB,GAAG,SAAS,CAE1C;IAID,IAAI,cAAc,IAAI,MAAM,CAE3B;IAOD,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAO/D,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAmB5C,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE/D;IAQD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAErC;CACJ"}
|
package/dist/BaseExecutor.js
CHANGED
|
@@ -32,8 +32,15 @@ export default class BaseExecutor {
|
|
|
32
32
|
glyph: this.glyph,
|
|
33
33
|
channels: Object.fromEntries(Object.entries(this.channels).map(([name, decl]) => [name, decl.mimetype])),
|
|
34
34
|
defaultChannel: this.defaultChannel,
|
|
35
|
+
flags: this.flags,
|
|
35
36
|
});
|
|
36
37
|
}
|
|
38
|
+
// {§manifest-flag-affinity} — environmental authority this runtime requires.
|
|
39
|
+
// Declared once here; the synthesized scheme face carries it into the one
|
|
40
|
+
// resolver that gates dispatch and directory teaching. Absent = always active.
|
|
41
|
+
get flags() {
|
|
42
|
+
return undefined;
|
|
43
|
+
}
|
|
37
44
|
// The channel a bare `READ <tag>://<coord>` resolves to. Defaults to the
|
|
38
45
|
// first declared channel; subprocess runtimes override to `stdout`.
|
|
39
46
|
get defaultChannel() {
|
package/dist/BaseExecutor.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"BaseExecutor.js","sourceRoot":"","sources":["../src/BaseExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,4DAA4D;AAC5D,MAAM,CAAC,OAAO,OAAgB,YAAY;IAC7B,OAAO,CAAS;IAChB,KAAK,CAAS;IAEvB,YAAY,EAAE,OAAO,EAAE,KAAK,EAAoB;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,kEAAkE;IAClE,gCAAgC;IAChC,8EAA8E;IAC9E,8EAA8E;IAC9E,6EAA6E;IAC7E,yDAAyD;IACzD,2EAA2E;IAC3E,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,IAAI,QAAQ;QACR,OAAO,YAAY,CAAC,mBAAmB,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,OAAO;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC7E;YACD,cAAc,EAAE,IAAI,CAAC,cAAc;
|
|
1
|
+
{"version":3,"file":"BaseExecutor.js","sourceRoot":"","sources":["../src/BaseExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,4DAA4D;AAC5D,MAAM,CAAC,OAAO,OAAgB,YAAY;IAC7B,OAAO,CAAS;IAChB,KAAK,CAAS;IAEvB,YAAY,EAAE,OAAO,EAAE,KAAK,EAAoB;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,kEAAkE;IAClE,gCAAgC;IAChC,8EAA8E;IAC9E,8EAA8E;IAC9E,6EAA6E;IAC7E,yDAAyD;IACzD,2EAA2E;IAC3E,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,IAAI,QAAQ;QACR,OAAO,YAAY,CAAC,mBAAmB,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,OAAO;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC7E;YACD,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC,CAAC;IACP,CAAC;IAED,6EAA6E;IAC7E,0EAA0E;IAC1E,+EAA+E;IAC/E,IAAI,KAAK;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,yEAAyE;IACzE,oEAAoE;IACpE,IAAI,cAAc;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;IAgBD,wEAAwE;IACxE,0EAA0E;IAC1E,wEAAwE;IACxE,iEAAiE;IACjE,EAAE;IACF,8EAA8E;IAC9E,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,4DAA4D;IAC5D,EAAE;IACF,sEAAsE;IACtE,4EAA4E;IAC5E,yEAAyE;IACzE,kEAAkE;IAClE,6EAA6E;IAC7E,iBAAiB;IACjB,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC7B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,8EAA8E;IAC9E,yEAAyE;IACzE,wEAAwE;IACxE,gEAAgE;IAChE,MAAM,CAAC,OAAsB;QACzB,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-execs",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.1",
|
|
4
4
|
"description": "Framework + contract for the @plurnk/plurnk-execs-* runtime executor packages.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"plurnk",
|
|
@@ -51,8 +51,8 @@
|
|
|
51
51
|
"prepublishOnly": "npm audit --audit-level=moderate && npm test"
|
|
52
52
|
},
|
|
53
53
|
"dependencies": {
|
|
54
|
-
"@plurnk/plurnk-contracts": "1.
|
|
55
|
-
"@plurnk/plurnk-meta": "1.
|
|
56
|
-
"@plurnk/plurnk-schemes": "1.
|
|
54
|
+
"@plurnk/plurnk-contracts": "1.9.1",
|
|
55
|
+
"@plurnk/plurnk-meta": "1.9.1",
|
|
56
|
+
"@plurnk/plurnk-schemes": "1.9.1"
|
|
57
57
|
}
|
|
58
58
|
}
|