@corenel/tools-node 0.10.0 → 0.11.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/dist/registryTokenExchange.d.ts +4 -0
- package/dist/registryTokenExchange.d.ts.map +1 -1
- package/dist/registryTokenExchange.js +8 -4
- package/dist/registryTokenExchange.js.map +1 -1
- package/dist/workflowPackage.d.ts +25 -0
- package/dist/workflowPackage.d.ts.map +1 -0
- package/dist/workflowPackage.js +77 -0
- package/dist/workflowPackage.js.map +1 -0
- package/package.json +3 -3
|
@@ -14,6 +14,7 @@ export type ExchangeFetch = (url: string, init: {
|
|
|
14
14
|
headers: Record<string, string>;
|
|
15
15
|
body: string;
|
|
16
16
|
signal: AbortSignal;
|
|
17
|
+
redirect: 'error';
|
|
17
18
|
}) => Promise<{
|
|
18
19
|
ok: boolean;
|
|
19
20
|
status: number;
|
|
@@ -28,9 +29,11 @@ export type ProbeFetch = (url: string, init: {
|
|
|
28
29
|
status: number;
|
|
29
30
|
}>;
|
|
30
31
|
export declare function exchangeRegistryToken(o: {
|
|
32
|
+
/** Set: the token reads only this exact version (the fleet always sets it). */
|
|
31
33
|
registryUrl: string;
|
|
32
34
|
orgKey: string;
|
|
33
35
|
packageName: string;
|
|
36
|
+
version?: string;
|
|
34
37
|
fetch?: ExchangeFetch;
|
|
35
38
|
timeoutMs?: number;
|
|
36
39
|
}): Promise<ExchangedToken>;
|
|
@@ -48,6 +51,7 @@ export declare function registryPullToken(o: {
|
|
|
48
51
|
registryUrl: string;
|
|
49
52
|
orgKey: string;
|
|
50
53
|
packageName: string;
|
|
54
|
+
version?: string;
|
|
51
55
|
fetch?: ExchangeFetch;
|
|
52
56
|
probe?: ProbeFetch;
|
|
53
57
|
timeoutMs?: number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registryTokenExchange.d.ts","sourceRoot":"","sources":["../registryTokenExchange.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"registryTokenExchange.d.ts","sourceRoot":"","sources":["../registryTokenExchange.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAC1D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,0BAA0B,oFAAoF,CAAC;AAC5H,eAAO,MAAM,2BAA2B,uGAAuG,CAAC;AAGhJ,oHAAoH;AACpH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AACpE,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,KAC5G,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AACxE,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AA4BjI,wBAAsB,qBAAqB,CAAC,CAAC,EAAE;IAC7C,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CACvH,GAAG,OAAO,CAAC,cAAc,CAAC,CA+B1B;AAED;+GAC+G;AAC/G,wBAAsB,gBAAgB,CAAC,CAAC,EAAE;IACxC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAClF,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBnB;AAED;2GAC2G;AAC3G,wBAAsB,iBAAiB,CAAC,CAAC,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC3I,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWzB"}
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
/* The one way a node or the fleet server turns an org registry key into a
|
|
2
2
|
* pull token (owner ruling R26). POST <registry>/auth/token-exchange with the
|
|
3
|
-
* org key as the bearer and `{ package, ttlSeconds }`, asking for a
|
|
4
|
-
* on ONE package
|
|
3
|
+
* org key as the bearer and `{ package, version?, ttlSeconds }`, asking for a
|
|
4
|
+
* read token on ONE package (one exact version when `version` is set) for 60 s;
|
|
5
|
+
* the registry answers 201 `{ token, expiresAt }`
|
|
5
6
|
* with expiresAt an ISO date. The org key goes only to that endpoint, never on
|
|
6
7
|
* a pull, and there is no fallback: a registry without the endpoint cannot
|
|
7
8
|
* serve private pulls and says so. A package anyone can read needs no token:
|
|
@@ -51,8 +52,10 @@ export async function exchangeRegistryToken(o) {
|
|
|
51
52
|
res = await race(doFetch(url, {
|
|
52
53
|
method: 'POST',
|
|
53
54
|
headers: { authorization: `Bearer ${o.orgKey}`, 'content-type': 'application/json' },
|
|
54
|
-
body: JSON.stringify({ package: o.packageName, ttlSeconds: TOKEN_EXCHANGE_TTL_SECONDS }),
|
|
55
|
+
body: JSON.stringify({ package: o.packageName, ...(o.version !== undefined ? { version: o.version } : {}), ttlSeconds: TOKEN_EXCHANGE_TTL_SECONDS }),
|
|
55
56
|
signal,
|
|
57
|
+
// The org key goes to this origin only: a redirect is a failure, not a hop to wherever it points.
|
|
58
|
+
redirect: 'error',
|
|
56
59
|
}));
|
|
57
60
|
}
|
|
58
61
|
catch (e) {
|
|
@@ -117,7 +120,8 @@ export async function registryPullToken(o) {
|
|
|
117
120
|
if (isPublic)
|
|
118
121
|
return null;
|
|
119
122
|
const t = await exchangeRegistryToken({
|
|
120
|
-
registryUrl: o.registryUrl, orgKey: o.orgKey, packageName: o.packageName,
|
|
123
|
+
registryUrl: o.registryUrl, orgKey: o.orgKey, packageName: o.packageName,
|
|
124
|
+
...(o.version !== undefined ? { version: o.version } : {}), ...(o.fetch ? { fetch: o.fetch } : {}), ...timeouts,
|
|
121
125
|
});
|
|
122
126
|
return t.token;
|
|
123
127
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registryTokenExchange.js","sourceRoot":"","sources":["../registryTokenExchange.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"registryTokenExchange.js","sourceRoot":"","sources":["../registryTokenExchange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;UAWU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAC1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,iFAAiF,CAAC;AAC5H,MAAM,CAAC,MAAM,2BAA2B,GAAG,oGAAoG,CAAC;AAChJ,qHAAqH;AACrH,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAC9C,oHAAoH;AACpH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAM,CAAC;AAWhD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE9D;;mCAEmC;AACnC,KAAK,UAAU,YAAY,CACzB,SAAiB,EACjB,QAAqB,EACrB,IAAiF;IAEjF,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,IAAI,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxB,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,QAAQ,EAAE,CAAC;QACxC,MAAM,CAAC,CAAC;IACV,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,CAG3C;IACC,MAAM,OAAO,GAAkB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,mBAAmB,EAAE,CAAC;IAC/D,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,yBAAyB,CAAC;IAC3D,OAAO,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,qDAAqD,SAAS,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC1I,IAAI,GAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBACpF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,0BAA0B,EAAE,CAAC;gBACpJ,MAAM;gBACN,kGAAkG;gBAClG,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtH,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,IAAsB,EAAE;YACxC,IAAI,CAAC;gBAAC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBAAC,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;QAChG,CAAC,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACpE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,KAAK,iBAAiB;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,WAAW,6BAA6B,CAAC,CAAC;YACjJ,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7F,OAAO,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;+GAC+G;AAC/G,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,CAEtC;IACC,MAAM,OAAO,GAAe,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;IACtF,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,yBAAyB,CAAC;IAC3D,OAAO,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,WAAW,WAAW,SAAS,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC1J,IAAI,GAAoC,CAAC;QACzC,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,WAAW,iBAAiB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC;AAED;2GAC2G;AAC3G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,CAEvC;IACC,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC;QACtC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ;KAC5G,CAAC,CAAC;IACH,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAC;QACpC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW;QACxE,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ;KAChH,CAAC,CAAC;IACH,OAAO,CAAC,CAAC,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,MAAM,CAAC,CAAU;IACxB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAA4B,CAAC,CAAC,CAAC,EAAE,CAAC;AACtG,CAAC;AAED,uGAAuG;AACvG,SAAS,WAAW,CAAC,IAAa;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAClI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;AACvC,CAAC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { type ParsedWorkflow, type Trigger, type VerifiedPackage, type WorkflowParameter } from '@prompd/core';
|
|
2
|
+
/** What a verified workflow package says about itself. */
|
|
3
|
+
export interface WorkflowPackageFacts {
|
|
4
|
+
/** The .pdflow to run: manifest.main, a path inside the package. */
|
|
5
|
+
main: string;
|
|
6
|
+
parsed: ParsedWorkflow;
|
|
7
|
+
description: string;
|
|
8
|
+
/** Trigger types in the trigger node the daemon fires for a package (SIDECAR_WORKFLOW_TRIGGERS less file-change,
|
|
9
|
+
* which fires only for a workflow in a sidecar folder), sorted, unique. What the fleet stores and the console shows. */
|
|
10
|
+
triggers: string[];
|
|
11
|
+
/** The workflow's declared parameters, as typed for run_workflow. */
|
|
12
|
+
parameters: WorkflowParameter[];
|
|
13
|
+
}
|
|
14
|
+
/** The trigger node's triggers that fire on the sidecar (spec 5.2). Only the
|
|
15
|
+
* `triggers` list is read: core 0.6.0 keeps the legacy trigger-node fields
|
|
16
|
+
* (`triggerType`, `schedule*`, ...) as @deprecated, and the daemon ignores them. */
|
|
17
|
+
export declare function sidecarTriggersOf(parsed: ParsedWorkflow): Trigger[];
|
|
18
|
+
/** Why `parameters` is not a list of named parameters, or null when it is (or
|
|
19
|
+
* is absent). The browser's rule, word for word. */
|
|
20
|
+
export declare function parametersProblem(params: unknown): string | null;
|
|
21
|
+
/** True when the .pdflow holds a node of type user-input (C13). */
|
|
22
|
+
export declare function hasUserInputNode(parsed: ParsedWorkflow): boolean;
|
|
23
|
+
/** Throws Error with a reason a person can read. */
|
|
24
|
+
export declare function inspectWorkflowPackage(pkg: Pick<VerifiedPackage, 'manifest' | 'files'>): WorkflowPackageFacts;
|
|
25
|
+
//# sourceMappingURL=workflowPackage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workflowPackage.d.ts","sourceRoot":"","sources":["../workflowPackage.ts"],"names":[],"mappings":"AAQA,OAAO,EAAqB,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMlI,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB;4HACwH;IACxH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED;;oFAEoF;AACpF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,EAAE,CAYnE;AAED;oDACoD;AACpD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAGhE;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,oBAAoB,CAwB7G"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/* The ONE rule for a deployable workflow package. The fleet resolver applies it at deploy time and the sidecar
|
|
2
|
+
* reconciler and loader apply it on every load, so a package either passes everywhere or nowhere. Node-free:
|
|
3
|
+
* it reads only the bytes @prompd/core already verified (VerifiedPackage.files) and imports only
|
|
4
|
+
* @prompd/core and @corenel/protocol.
|
|
5
|
+
*
|
|
6
|
+
* A deployable workflow names its .pdflow in the manifest's `main`, parses (invalid JSON never runs, and
|
|
7
|
+
* `parameters` must be a list of named parameters: the browser's rule), carries a description agents can read,
|
|
8
|
+
* and has no user-input node, since a workflow the fleet deploys runs unattended and could never answer it. */
|
|
9
|
+
import { parseWorkflowJson } from '@prompd/core';
|
|
10
|
+
import { SIDECAR_WORKFLOW_TRIGGERS } from '@corenel/protocol';
|
|
11
|
+
/** A package has no folder to watch, so its file-change trigger never fires (workflowSchedule.ts never arms it). */
|
|
12
|
+
const PACKAGE_NEVER_FIRES = 'file-change';
|
|
13
|
+
/** The trigger node's triggers that fire on the sidecar (spec 5.2). Only the
|
|
14
|
+
* `triggers` list is read: core 0.6.0 keeps the legacy trigger-node fields
|
|
15
|
+
* (`triggerType`, `schedule*`, ...) as @deprecated, and the daemon ignores them. */
|
|
16
|
+
export function sidecarTriggersOf(parsed) {
|
|
17
|
+
const nodes = parsed.file?.nodes;
|
|
18
|
+
if (!Array.isArray(nodes))
|
|
19
|
+
return [];
|
|
20
|
+
const node = nodes.find((n) => !!n && typeof n === 'object' && n.type === 'trigger');
|
|
21
|
+
const data = node && typeof node === 'object' ? node.data : undefined;
|
|
22
|
+
const raw = data && typeof data === 'object' ? data.triggers : undefined;
|
|
23
|
+
if (!Array.isArray(raw))
|
|
24
|
+
return [];
|
|
25
|
+
return raw.filter((t) => {
|
|
26
|
+
if (!t || typeof t !== 'object')
|
|
27
|
+
return false;
|
|
28
|
+
const type = t.type;
|
|
29
|
+
return typeof type === 'string' && SIDECAR_WORKFLOW_TRIGGERS.includes(type);
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
/** Why `parameters` is not a list of named parameters, or null when it is (or
|
|
33
|
+
* is absent). The browser's rule, word for word. */
|
|
34
|
+
export function parametersProblem(params) {
|
|
35
|
+
if (params === undefined)
|
|
36
|
+
return null;
|
|
37
|
+
if (!Array.isArray(params))
|
|
38
|
+
return 'parameters must be a list';
|
|
39
|
+
const i = params.findIndex((p) => !p || typeof p !== 'object' || Array.isArray(p) || typeof p.name !== 'string');
|
|
40
|
+
return i === -1 ? null : `parameters item ${i + 1} is not a parameter with a name`;
|
|
41
|
+
}
|
|
42
|
+
/** True when the .pdflow holds a node of type user-input (C13). */
|
|
43
|
+
export function hasUserInputNode(parsed) {
|
|
44
|
+
const nodes = parsed.file?.nodes;
|
|
45
|
+
return Array.isArray(nodes) && nodes.some((n) => !!n && typeof n === 'object' && n.type === 'user-input');
|
|
46
|
+
}
|
|
47
|
+
/** Throws Error with a reason a person can read. */
|
|
48
|
+
export function inspectWorkflowPackage(pkg) {
|
|
49
|
+
const ref = `${pkg.manifest.name}@${pkg.manifest.version}`;
|
|
50
|
+
const main = pkg.manifest.main;
|
|
51
|
+
if (typeof main !== 'string' || main.trim() === '')
|
|
52
|
+
throw new Error(`${ref} names no .pdflow to run (main)`);
|
|
53
|
+
const bytes = main.toLowerCase().endsWith('.pdflow') ? pkg.files.get(main) : undefined;
|
|
54
|
+
if (!bytes)
|
|
55
|
+
throw new Error(`${ref}: main ${main} is not a .pdflow in the package`);
|
|
56
|
+
const r = parseWorkflowJson(new TextDecoder().decode(bytes));
|
|
57
|
+
// parseWorkflow does not throw on bad JSON: it returns a placeholder file
|
|
58
|
+
// plus an INVALID_JSON error, which must never run.
|
|
59
|
+
if (!r.parsed || r.parsed.errors?.some((e) => e.code === 'INVALID_JSON')) {
|
|
60
|
+
throw new Error(`${ref}: ${main} is not a valid workflow (${r.errors.join('; ') || 'it is not a workflow'})`);
|
|
61
|
+
}
|
|
62
|
+
const parsed = r.parsed;
|
|
63
|
+
const badParams = parametersProblem(parsed.file.parameters);
|
|
64
|
+
if (badParams)
|
|
65
|
+
throw new Error(`${ref}: ${main} is not a valid workflow (${badParams})`);
|
|
66
|
+
const meta = parsed.file.metadata;
|
|
67
|
+
const rawDescription = meta && typeof meta === 'object' ? meta.description : undefined;
|
|
68
|
+
const description = typeof rawDescription === 'string' ? rawDescription.trim() : '';
|
|
69
|
+
if (!description)
|
|
70
|
+
throw new Error(`${ref} is a workflow without a description; agents need one to know when to call it.`);
|
|
71
|
+
if (hasUserInputNode(parsed)) {
|
|
72
|
+
throw new Error(`${ref} has a user-input node, which waits for a person; a workflow the fleet deploys runs unattended and could never answer it.`);
|
|
73
|
+
}
|
|
74
|
+
const triggers = [...new Set(sidecarTriggersOf(parsed).map((t) => t.type))].filter((t) => t !== PACKAGE_NEVER_FIRES).sort();
|
|
75
|
+
return { main, parsed, description, triggers, parameters: parsed.file.parameters ?? [] };
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=workflowPackage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workflowPackage.js","sourceRoot":"","sources":["../workflowPackage.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@corenel/tools-node",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.11.0",
|
|
4
4
|
"license": "Elastic-2.0",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Corenel node capabilities — the tools-web twin. A disk-backed FileService (the harness file tools + node PromptHost workspace) over node:fs, confined to a root. Shell/secrets/~/.corenel to follow.",
|
|
@@ -16,8 +16,8 @@
|
|
|
16
16
|
},
|
|
17
17
|
"dependencies": {
|
|
18
18
|
"@prompd/core": "0.7.0",
|
|
19
|
-
"@corenel/protocol": "0.
|
|
20
|
-
"@corenel/harness": "0.
|
|
19
|
+
"@corenel/protocol": "0.19.0",
|
|
20
|
+
"@corenel/harness": "0.21.0"
|
|
21
21
|
},
|
|
22
22
|
"devDependencies": {
|
|
23
23
|
"@types/node": "^24.13.1",
|