@bluelibs/runner-dev 6.2.0 → 6.3.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/README.md +131 -12
- package/dist/cli/generators/initUtils.js +1 -1
- package/dist/cli/generators/initUtils.js.map +1 -1
- package/dist/cli/generators/scaffold/templates/README.md.js +17 -4
- package/dist/cli/generators/scaffold/templates/README.md.js.map +1 -1
- package/dist/cli/generators/scaffold/templates/index.d.ts +2 -1
- package/dist/cli/generators/scaffold/templates/index.js +5 -3
- package/dist/cli/generators/scaffold/templates/index.js.map +1 -1
- package/dist/cli/generators/scaffold/templates/package.json.d.ts +7 -2
- package/dist/cli/generators/scaffold/templates/package.json.js +7 -2
- package/dist/cli/generators/scaffold/templates/package.json.js.map +1 -1
- package/dist/cli/generators/scaffold/templates/src/app.test.ts.d.ts +1 -0
- package/dist/cli/generators/scaffold/templates/src/app.test.ts.js +29 -0
- package/dist/cli/generators/scaffold/templates/src/app.test.ts.js.map +1 -0
- package/dist/cli/generators/scaffold/templates/src/app.ts.d.ts +1 -0
- package/dist/cli/generators/scaffold/templates/src/app.ts.js +15 -0
- package/dist/cli/generators/scaffold/templates/src/app.ts.js.map +1 -0
- package/dist/cli/generators/scaffold/templates/src/main.ts.js +3 -10
- package/dist/cli/generators/scaffold/templates/src/main.ts.js.map +1 -1
- package/dist/cli/generators/scaffold/templates/tsconfig.json.d.ts +2 -0
- package/dist/cli/generators/scaffold/templates/tsconfig.json.js +2 -0
- package/dist/cli/generators/scaffold/templates/tsconfig.json.js.map +1 -1
- package/dist/cli/generators/scaffold.js +2 -1
- package/dist/cli/generators/scaffold.js.map +1 -1
- package/dist/cli.js +0 -0
- package/dist/docs/packageDocs.d.ts +16 -0
- package/dist/docs/packageDocs.js +107 -0
- package/dist/docs/packageDocs.js.map +1 -0
- package/dist/exportDocs.d.ts +10 -0
- package/dist/exportDocs.js +98 -0
- package/dist/exportDocs.js.map +1 -0
- package/dist/generated/resolvers-types.d.ts +114 -29
- package/dist/index.d.ts +4 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/env.d.ts +5 -0
- package/dist/mcp/env.js +30 -1
- package/dist/mcp/env.js.map +1 -1
- package/dist/mcp/help.d.ts +8 -1
- package/dist/mcp/help.js +30 -4
- package/dist/mcp/help.js.map +1 -1
- package/dist/mcp/http.js +10 -0
- package/dist/mcp/http.js.map +1 -1
- package/dist/mcp/projectOverview.js +13 -4
- package/dist/mcp/projectOverview.js.map +1 -1
- package/dist/mcp/snapshot.d.ts +22 -0
- package/dist/mcp/snapshot.js +347 -0
- package/dist/mcp/snapshot.js.map +1 -0
- package/dist/mcp/tools/graphql.mutation.js +4 -1
- package/dist/mcp/tools/graphql.mutation.js.map +1 -1
- package/dist/mcp/tools/graphql.ping.js +1 -1
- package/dist/mcp/tools/graphql.ping.js.map +1 -1
- package/dist/mcp/tools/graphql.query.js +1 -1
- package/dist/mcp/tools/graphql.query.js.map +1 -1
- package/dist/mcp/tools/help.read.js +7 -5
- package/dist/mcp/tools/help.read.js.map +1 -1
- package/dist/mcp/tools/help.runner.js +3 -1
- package/dist/mcp/tools/help.runner.js.map +1 -1
- package/dist/mcp/tools/help.runnerDev.js +4 -4
- package/dist/mcp/tools/help.runnerDev.js.map +1 -1
- package/dist/mcp.js +4 -9
- package/dist/mcp.js.map +1 -1
- package/dist/resources/docsPayload.d.ts +33 -0
- package/dist/resources/docsPayload.js +171 -0
- package/dist/resources/docsPayload.js.map +1 -0
- package/dist/resources/docsUiAssets.d.ts +27 -0
- package/dist/resources/docsUiAssets.js +150 -0
- package/dist/resources/docsUiAssets.js.map +1 -0
- package/dist/resources/graphql-accumulator.resource.d.ts +1 -0
- package/dist/resources/graphql-accumulator.resource.js +30 -26
- package/dist/resources/graphql-accumulator.resource.js.map +1 -1
- package/dist/resources/live.resource.js +1 -1
- package/dist/resources/live.resource.js.map +1 -1
- package/dist/resources/models/Introspector.d.ts +12 -0
- package/dist/resources/models/Introspector.js +51 -28
- package/dist/resources/models/Introspector.js.map +1 -1
- package/dist/resources/models/initializeFromStore.js +5 -5
- package/dist/resources/models/initializeFromStore.js.map +1 -1
- package/dist/resources/models/initializeFromStore.utils.d.ts +2 -2
- package/dist/resources/models/initializeFromStore.utils.js +395 -68
- package/dist/resources/models/initializeFromStore.utils.js.map +1 -1
- package/dist/resources/models/introspector.tools.js +88 -4
- package/dist/resources/models/introspector.tools.js.map +1 -1
- package/dist/resources/routeHandlers/createDocsServeHandler.js +13 -37
- package/dist/resources/routeHandlers/createDocsServeHandler.js.map +1 -1
- package/dist/resources/routeHandlers/getDocsData.d.ts +1 -6
- package/dist/resources/routeHandlers/getDocsData.js +10 -168
- package/dist/resources/routeHandlers/getDocsData.js.map +1 -1
- package/dist/resources/server.resource.js +0 -1
- package/dist/resources/server.resource.js.map +1 -1
- package/dist/resources/ui.static.js +4 -9
- package/dist/resources/ui.static.js.map +1 -1
- package/dist/schema/model.d.ts +18 -0
- package/dist/schema/model.js +14 -0
- package/dist/schema/model.js.map +1 -1
- package/dist/schema/query.js +3 -3
- package/dist/schema/query.js.map +1 -1
- package/dist/schema/types/AllType.js +2 -21
- package/dist/schema/types/AllType.js.map +1 -1
- package/dist/schema/types/ErrorType.js +1 -3
- package/dist/schema/types/ErrorType.js.map +1 -1
- package/dist/schema/types/EventType.js +6 -19
- package/dist/schema/types/EventType.js.map +1 -1
- package/dist/schema/types/HookType.js +4 -16
- package/dist/schema/types/HookType.js.map +1 -1
- package/dist/schema/types/ResourceType.js +50 -23
- package/dist/schema/types/ResourceType.js.map +1 -1
- package/dist/schema/types/TaskLikeCommon.js +2 -2
- package/dist/schema/types/TaskLikeCommon.js.map +1 -1
- package/dist/schema/types/TaskType.js +6 -19
- package/dist/schema/types/TaskType.js.map +1 -1
- package/dist/schema/types/middleware/UsageTypes.d.ts +1 -0
- package/dist/schema/types/middleware/UsageTypes.js +16 -5
- package/dist/schema/types/middleware/UsageTypes.js.map +1 -1
- package/dist/schema/types/middleware/common.js +2 -2
- package/dist/schema/types/middleware/common.js.map +1 -1
- package/dist/ui/.vite/manifest.json +2 -2
- package/dist/ui/assets/docs-Beb_xRuE.js +304 -0
- package/dist/ui/assets/docs-Beb_xRuE.js.map +1 -0
- package/dist/ui/assets/docs-lid1amCk.css +1 -0
- package/dist/ui/docs/favicon.ico +0 -0
- package/dist/utils/lane-resources.d.ts +69 -0
- package/dist/utils/lane-resources.js +145 -0
- package/dist/utils/lane-resources.js.map +1 -1
- package/dist/utils/runner-namespace.d.ts +1 -0
- package/dist/utils/runner-namespace.js +9 -0
- package/dist/utils/runner-namespace.js.map +1 -0
- package/dist/utils/schemaFormat.d.ts +6 -0
- package/dist/utils/schemaFormat.js +244 -0
- package/dist/utils/schemaFormat.js.map +1 -0
- package/dist/utils/system-namespace.d.ts +1 -0
- package/dist/utils/system-namespace.js +9 -0
- package/dist/utils/system-namespace.js.map +1 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +21 -5
- package/readmes/API_REFERENCE.md +364 -0
- package/readmes/COMPACT_GUIDE.md +254 -0
- package/skills/core/SKILL.md +27 -0
- package/skills/core/references/readmes/API_REFERENCE.md +364 -0
- package/skills/core/references/readmes/COMPACT_GUIDE.md +254 -0
- package/AI.md +0 -630
- package/dist/ui/assets/docs-CWJO6emS.css +0 -1
- package/dist/ui/assets/docs-Zej7hPlV.js +0 -302
- package/dist/ui/assets/docs-Zej7hPlV.js.map +0 -1
- package/readmes/runner-AI.md +0 -917
- package/readmes/runner-durable-workflows.md +0 -2247
- package/readmes/runner-full-guide.md +0 -6010
- package/readmes/runner-remote-lanes.md +0 -910
|
@@ -14,7 +14,7 @@ function registerGraphQLPing(server) {
|
|
|
14
14
|
content: [
|
|
15
15
|
{
|
|
16
16
|
type: "text",
|
|
17
|
-
text: JSON.stringify({ ok: true, result,
|
|
17
|
+
text: JSON.stringify({ ok: true, result, source: (0, env_1.assertGraphqlSourceDescription)() }, null, 2),
|
|
18
18
|
},
|
|
19
19
|
],
|
|
20
20
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graphql.ping.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.ping.ts"],"names":[],"mappings":";;AAIA,kDAwBC;AA3BD,kCAAsC;AACtC,
|
|
1
|
+
{"version":3,"file":"graphql.ping.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.ping.ts"],"names":[],"mappings":";;AAIA,kDAwBC;AA3BD,kCAAsC;AACtC,gCAAwD;AAExD,SAAgB,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAA,oCAA8B,GAAE,EAAE,EAC9D,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -7,7 +7,7 @@ const format_1 = require("../format");
|
|
|
7
7
|
function registerGraphQLQuery(server) {
|
|
8
8
|
server.registerTool("graphql_query", {
|
|
9
9
|
title: "GraphQL Query",
|
|
10
|
-
description: "Execute a GraphQL query against the configured
|
|
10
|
+
description: "Execute a GraphQL query against the configured live endpoint or exported snapshot",
|
|
11
11
|
inputSchema: {
|
|
12
12
|
query: zod_1.z.string(),
|
|
13
13
|
variables: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.unknown())]).optional(),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graphql.query.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.query.ts"],"names":[],"mappings":";;AAKA,
|
|
1
|
+
{"version":3,"file":"graphql.query.js","sourceRoot":"","sources":["../../../src/mcp/tools/graphql.query.ts"],"names":[],"mappings":";;AAKA,oDA+CC;AApDD,6BAAwB;AAExB,kCAAmD;AACnD,sCAA0D;AAE1D,SAAgB,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,mFAAmF;QACrF,WAAW,EAAE;YACX,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClE,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/C,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACrD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B;KACF,EACD,KAAK,EAAE,EACL,KAAK,EACL,SAAS,EACT,aAAa,EACb,MAAM,EACN,aAAa,EACb,QAAQ,EACR,KAAK,GACN,EAAE,EAAE;QACH,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC;YAC/B,KAAK;YACL,SAAS,EAAE,IAAA,kBAAW,EAAC,SAAS,CAAC;YACjC,aAAa;SACd,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,IAAA,sCAA6B,EAAC,MAAM,EAAE;gBAC/C,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACtD,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACtD,KAAK,EAAE,KAAK,IAAI,sBAAsB;aACvC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -23,22 +23,24 @@ function registerHelpRead(server) {
|
|
|
23
23
|
filePath = pkg.filePath;
|
|
24
24
|
}
|
|
25
25
|
else if (doc === "runner") {
|
|
26
|
-
const pkg = await (0, help_1.
|
|
26
|
+
const pkg = await (0, help_1.readFirstAvailablePackageDoc)("@bluelibs/runner", [
|
|
27
|
+
...help_1.RUNNER_FRAMEWORK_COMPACT_DOC_PATHS,
|
|
28
|
+
]);
|
|
27
29
|
content = pkg.content;
|
|
28
30
|
filePath = pkg.filePath;
|
|
29
31
|
}
|
|
30
32
|
else {
|
|
31
33
|
const readmeRes = await (0, help_1.readDocContent)("readme");
|
|
32
|
-
const
|
|
34
|
+
const compactRes = await (0, help_1.readDocContent)("compact");
|
|
33
35
|
const sections = [];
|
|
34
36
|
if (readmeRes.content) {
|
|
35
37
|
sections.push(`# Runner-Dev Application\n\n${readmeRes.content}`);
|
|
36
38
|
}
|
|
37
|
-
if (
|
|
38
|
-
sections.push(`#
|
|
39
|
+
if (compactRes.content) {
|
|
40
|
+
sections.push(`# Runner-Dev Compact Guide\n\n${compactRes.content}`);
|
|
39
41
|
}
|
|
40
42
|
content = sections.join("\n\n---\n\n");
|
|
41
|
-
filePath = `${readmeRes.filePath} + ${
|
|
43
|
+
filePath = `${readmeRes.filePath} + ${compactRes.filePath}`;
|
|
42
44
|
}
|
|
43
45
|
if (!content) {
|
|
44
46
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"help.read.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.read.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"help.read.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.read.ts"],"names":[],"mappings":"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"}
|
|
@@ -12,7 +12,9 @@ function registerHelpRunner(server) {
|
|
|
12
12
|
toc: zod_1.z.boolean().optional(),
|
|
13
13
|
},
|
|
14
14
|
}, async ({ headingIncludes, toc }) => {
|
|
15
|
-
const pkg = await (0, help_1.
|
|
15
|
+
const pkg = await (0, help_1.readFirstAvailablePackageDoc)("@bluelibs/runner", [
|
|
16
|
+
...help_1.RUNNER_FRAMEWORK_COMPACT_DOC_PATHS,
|
|
17
|
+
]);
|
|
16
18
|
let content = pkg.content;
|
|
17
19
|
if (!content) {
|
|
18
20
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"help.runner.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.runner.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"help.runner.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.runner.ts"],"names":[],"mappings":";;AASA,gDA+DC;AAxED,6BAAwB;AAExB,kCAKiB;AAEjB,SAAgB,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,4IAA4I;QAC9I,WAAW,EAAE;YACX,eAAe,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtE,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC5B;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,MAAM,IAAA,mCAA4B,EAAC,kBAAkB,EAAE;YACjE,GAAG,yCAAkC;SACtC,CAAC,CAAC;QACH,IAAI,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAE1B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,6CAA6C,GAAG,CAAC,QAAQ,EAAE;qBAClE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,KAAK,GAAG;gBACZ,wCAAwC;gBACxC,EAAE;gBACF,GAAG,IAAA,eAAQ,EAAC,OAAO,CAAC;aACrB,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBACnD,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAEtB,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACpD,CAAC;YAEF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAA,gCAAyB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBACjE,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,uCAAuC,OAAO,EAAE;iBACvD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -13,13 +13,13 @@ function registerHelpRunnerDev(server) {
|
|
|
13
13
|
},
|
|
14
14
|
}, async ({ headingIncludes, toc }) => {
|
|
15
15
|
const readmeRes = await (0, help_1.readDocContent)("readme");
|
|
16
|
-
const
|
|
16
|
+
const compactRes = await (0, help_1.readDocContent)("compact");
|
|
17
17
|
const sections = [];
|
|
18
18
|
if (readmeRes.content) {
|
|
19
19
|
sections.push(`# Runner-Dev Application\n\n${readmeRes.content}`);
|
|
20
20
|
}
|
|
21
|
-
if (
|
|
22
|
-
sections.push(`#
|
|
21
|
+
if (compactRes.content) {
|
|
22
|
+
sections.push(`# Runner-Dev Compact Guide\n\n${compactRes.content}`);
|
|
23
23
|
}
|
|
24
24
|
const content = sections.join("\n\n---\n\n");
|
|
25
25
|
if (!content) {
|
|
@@ -27,7 +27,7 @@ function registerHelpRunnerDev(server) {
|
|
|
27
27
|
content: [
|
|
28
28
|
{
|
|
29
29
|
type: "text",
|
|
30
|
-
text: "Runner-Dev documentation not found. Please ensure README.md and
|
|
30
|
+
text: "Runner-Dev documentation not found. Please ensure README.md and skills/runner-dev/references/COMPACT_GUIDE.md exist.",
|
|
31
31
|
},
|
|
32
32
|
],
|
|
33
33
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"help.runnerDev.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.runnerDev.ts"],"names":[],"mappings":";;AAIA,sDAgEC;AApED,6BAAwB;AAExB,kCAA8E;AAE9E,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,kHAAkH;QACpH,WAAW,EAAE;YACX,eAAe,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtE,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC5B;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE;QACjC,MAAM,SAAS,GAAG,MAAM,IAAA,qBAAc,EAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,
|
|
1
|
+
{"version":3,"file":"help.runnerDev.js","sourceRoot":"","sources":["../../../src/mcp/tools/help.runnerDev.ts"],"names":[],"mappings":";;AAIA,sDAgEC;AApED,6BAAwB;AAExB,kCAA8E;AAE9E,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,kHAAkH;QACpH,WAAW,EAAE;YACX,eAAe,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACtE,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC5B;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE;QACjC,MAAM,SAAS,GAAG,MAAM,IAAA,qBAAc,EAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,MAAM,IAAA,qBAAc,EAAC,SAAS,CAAC,CAAC;QAEnD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,+BAA+B,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,iCAAiC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sHAAsH;qBAC7H;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,KAAK,GAAG;gBACZ,gDAAgD;gBAChD,EAAE;gBACF,GAAG,IAAA,eAAQ,EAAC,OAAO,CAAC;aACrB,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBACnD,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAEtB,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACpD,CAAC;YAEF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAA,gCAAyB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO,EAAE,CAAC,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC"}
|
package/dist/mcp.js
CHANGED
|
@@ -11,9 +11,6 @@ const graphql_mutation_1 = require("./mcp/tools/graphql.mutation");
|
|
|
11
11
|
const graphql_introspect_1 = require("./mcp/tools/graphql.introspect");
|
|
12
12
|
const graphql_schemaSdl_1 = require("./mcp/tools/graphql.schemaSdl");
|
|
13
13
|
const graphql_ping_1 = require("./mcp/tools/graphql.ping");
|
|
14
|
-
const help_read_1 = require("./mcp/tools/help.read");
|
|
15
|
-
const help_runner_1 = require("./mcp/tools/help.runner");
|
|
16
|
-
const help_runnerDev_1 = require("./mcp/tools/help.runnerDev");
|
|
17
14
|
const env_1 = require("./mcp/env");
|
|
18
15
|
// Create an MCP server
|
|
19
16
|
const server = new mcp_js_1.McpServer({
|
|
@@ -22,9 +19,6 @@ const server = new mcp_js_1.McpServer({
|
|
|
22
19
|
});
|
|
23
20
|
// Register tools
|
|
24
21
|
(0, graphql_query_1.registerGraphQLQuery)(server);
|
|
25
|
-
(0, help_read_1.registerHelpRead)(server);
|
|
26
|
-
(0, help_runner_1.registerHelpRunner)(server);
|
|
27
|
-
(0, help_runnerDev_1.registerHelpRunnerDev)(server);
|
|
28
22
|
(0, graphql_mutation_1.registerGraphQLMutation)(server);
|
|
29
23
|
(0, graphql_introspect_1.registerGraphQLIntrospect)(server);
|
|
30
24
|
(0, graphql_schemaSdl_1.registerGraphQLSchemaSDL)(server);
|
|
@@ -64,12 +58,13 @@ server.registerResource("graphql_schema_sdl", new mcp_js_1.ResourceTemplate("gra
|
|
|
64
58
|
});
|
|
65
59
|
// Start receiving messages on stdin and sending messages on stdout
|
|
66
60
|
const transport = new stdio_js_1.StdioServerTransport();
|
|
67
|
-
|
|
61
|
+
const source = (0, env_1.getGraphqlSourceDescription)();
|
|
62
|
+
if (source) {
|
|
68
63
|
server.connect(transport).then(() => {
|
|
69
|
-
console.log(`Runner Dev MCP server started: ${env_1.
|
|
64
|
+
console.log(`Runner Dev MCP server started: ${(0, env_1.assertGraphqlSourceDescription)()}`);
|
|
70
65
|
});
|
|
71
66
|
}
|
|
72
67
|
else {
|
|
73
|
-
console.error("Runner Dev MCP server: ENDPOINT
|
|
68
|
+
console.error("Runner Dev MCP server: set ENDPOINT/GRAPHQL_ENDPOINT or SNAPSHOT_FILE.");
|
|
74
69
|
}
|
|
75
70
|
//# sourceMappingURL=mcp.js.map
|
package/dist/mcp.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";;AAAA,oEAGiD;AACjD,wEAAiF;AACjF,qCAAgD;AAChD,qCAAyC;AACzC,yCAA8C;AAC9C,2DAAgE;AAChE,6DAAiE;AACjE,mEAAuE;AACvE,uEAA2E;AAC3E,qEAAyE;AACzE,2DAA+D;AAC/D,
|
|
1
|
+
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";;AAAA,oEAGiD;AACjD,wEAAiF;AACjF,qCAAgD;AAChD,qCAAyC;AACzC,yCAA8C;AAC9C,2DAAgE;AAChE,6DAAiE;AACjE,mEAAuE;AACvE,uEAA2E;AAC3E,qEAAyE;AACzE,2DAA+D;AAC/D,mCAGmB;AAEnB,uBAAuB;AACvB,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB;AACjB,IAAA,oCAAoB,EAAC,MAAM,CAAC,CAAC;AAE7B,IAAA,0CAAuB,EAAC,MAAM,CAAC,CAAC;AAEhC,IAAA,8CAAyB,EAAC,MAAM,CAAC,CAAC;AAElC,IAAA,4CAAwB,EAAC,MAAM,CAAC,CAAC;AAEjC,IAAA,kCAAmB,EAAC,MAAM,CAAC,CAAC;AAE5B,wFAAwF;AACxF,IAAA,yCAAuB,EAAC,MAAM,CAAC,CAAC;AAEhC,uCAAuC;AACvC,MAAM,CAAC,gBAAgB,CACrB,gBAAgB,EAChB,IAAI,yBAAgB,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC7D;IACE,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE,yDAAyD;CACvE,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;IACZ,MAAM,kBAAkB,GAAG,IAAA,+BAAqB,GAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAW,EAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAChE,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,2CAA2C;AAC3C,MAAM,CAAC,gBAAgB,CACrB,oBAAoB,EACpB,IAAI,yBAAgB,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACjE;IACE,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,8DAA8D;CAC5E,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;IACZ,MAAM,GAAG,GAAG,MAAM,IAAA,uBAAc,GAAE,CAAC;IACnC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,GAAG;aACV;SACF;KACF,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,mEAAmE;AACnE,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,GAAG,IAAA,iCAA2B,GAAE,CAAC;AAC7C,IAAI,MAAM,EAAE,CAAC;IACX,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QAClC,OAAO,CAAC,GAAG,CACT,kCAAkC,IAAA,oCAA8B,GAAE,EAAE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CACX,wEAAwE,CACzE,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { Store } from "@bluelibs/runner";
|
|
2
|
+
import { Introspector, type SerializedIntrospector } from "./models/Introspector";
|
|
3
|
+
export interface DocsContentPayload {
|
|
4
|
+
minimalMd: string;
|
|
5
|
+
completeMd: string;
|
|
6
|
+
}
|
|
7
|
+
export type DocumentationMode = "live" | "catalog";
|
|
8
|
+
export interface DocsPagePayload {
|
|
9
|
+
mode: DocumentationMode;
|
|
10
|
+
namespacePrefix?: string;
|
|
11
|
+
introspectorData: SerializedIntrospector;
|
|
12
|
+
runnerFrameworkMd: string;
|
|
13
|
+
runnerDevMd: string;
|
|
14
|
+
docsContent: DocsContentPayload;
|
|
15
|
+
projectOverviewMd: string;
|
|
16
|
+
graphqlSdl?: string;
|
|
17
|
+
}
|
|
18
|
+
export interface DocsPayloadConfig {
|
|
19
|
+
store: Store;
|
|
20
|
+
introspector: Introspector;
|
|
21
|
+
namespacePrefix?: string;
|
|
22
|
+
mode?: DocumentationMode;
|
|
23
|
+
logger?: {
|
|
24
|
+
warn?: (message: string) => void;
|
|
25
|
+
};
|
|
26
|
+
getGraphqlSdl?: () => string;
|
|
27
|
+
coverage?: {
|
|
28
|
+
getSummaryForPath: (p: string | null | undefined) => Promise<{
|
|
29
|
+
percentage?: number | null;
|
|
30
|
+
} | null>;
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
export declare function buildDocsPagePayload(config: DocsPayloadConfig): Promise<DocsPagePayload>;
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.buildDocsPagePayload = buildDocsPagePayload;
|
|
7
|
+
const promises_1 = __importDefault(require("node:fs/promises"));
|
|
8
|
+
const node_path_1 = __importDefault(require("node:path"));
|
|
9
|
+
const packageDocs_1 = require("../docs/packageDocs");
|
|
10
|
+
const initializeFromStore_1 = require("./models/initializeFromStore");
|
|
11
|
+
const durable_runtime_1 = require("./models/durable.runtime");
|
|
12
|
+
async function readDocsContent() {
|
|
13
|
+
const [minimalDoc, completeDoc] = await Promise.all([
|
|
14
|
+
(0, packageDocs_1.readFirstAvailablePackageDoc)("@bluelibs/runner", [
|
|
15
|
+
...packageDocs_1.RUNNER_FRAMEWORK_COMPACT_DOC_PATHS,
|
|
16
|
+
]),
|
|
17
|
+
(0, packageDocs_1.readFirstAvailablePackageDoc)("@bluelibs/runner", [
|
|
18
|
+
...packageDocs_1.RUNNER_FRAMEWORK_COMPLETE_DOC_PATHS,
|
|
19
|
+
]),
|
|
20
|
+
]);
|
|
21
|
+
return {
|
|
22
|
+
minimalMd: minimalDoc.content,
|
|
23
|
+
completeMd: completeDoc.content,
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
async function readRunnerDevCompactGuide() {
|
|
27
|
+
const packageDoc = await (0, packageDocs_1.readPackageDoc)("@bluelibs/runner-dev", "skills/core/references/readmes/COMPACT_GUIDE.md");
|
|
28
|
+
if (packageDoc.content) {
|
|
29
|
+
return packageDoc.content;
|
|
30
|
+
}
|
|
31
|
+
const localFallbackPath = node_path_1.default.resolve(__dirname, "../../skills/core/references/readmes/COMPACT_GUIDE.md");
|
|
32
|
+
let localFallback;
|
|
33
|
+
try {
|
|
34
|
+
localFallback = await promises_1.default.readFile(localFallbackPath, "utf8");
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
const reason = error instanceof Error ? error.message : "Unknown filesystem error";
|
|
38
|
+
throw new Error(`Runner-Dev compact guide could not be read at ${localFallbackPath}: ${reason}`);
|
|
39
|
+
}
|
|
40
|
+
if (!localFallback) {
|
|
41
|
+
throw new Error(`Runner-Dev compact guide is empty at ${localFallbackPath}.`);
|
|
42
|
+
}
|
|
43
|
+
return localFallback;
|
|
44
|
+
}
|
|
45
|
+
function buildProjectOverviewMarkdown(introspector) {
|
|
46
|
+
const overviewLines = [];
|
|
47
|
+
try {
|
|
48
|
+
const tasks = introspector.getTasks?.() ?? [];
|
|
49
|
+
const hooks = introspector.getHooks?.() ?? [];
|
|
50
|
+
const resources = introspector.getResources?.() ?? [];
|
|
51
|
+
const middlewares = introspector.getMiddlewares?.() ?? [];
|
|
52
|
+
const events = introspector.getEvents?.() ?? [];
|
|
53
|
+
overviewLines.push(`# Project Overview`);
|
|
54
|
+
overviewLines.push("");
|
|
55
|
+
overviewLines.push(`- Tasks: ${tasks.length}`);
|
|
56
|
+
overviewLines.push(`- Hooks: ${hooks.length}`);
|
|
57
|
+
overviewLines.push(`- Resources: ${resources.length}`);
|
|
58
|
+
overviewLines.push(`- Middleware: ${middlewares.length}`);
|
|
59
|
+
overviewLines.push(`- Events: ${events.length}`);
|
|
60
|
+
overviewLines.push("");
|
|
61
|
+
const sample = (arr, n = 10) => arr.slice(0, n);
|
|
62
|
+
const fmt = (id, title, description) => {
|
|
63
|
+
const lineTitle = title && title.trim().length ? title : id;
|
|
64
|
+
const extra = description && description.trim().length ? ` — ${description}` : "";
|
|
65
|
+
return `- ${lineTitle} {${id}}${extra}`;
|
|
66
|
+
};
|
|
67
|
+
if (tasks.length) {
|
|
68
|
+
overviewLines.push(`## Sample Tasks`);
|
|
69
|
+
for (const t of sample(tasks)) {
|
|
70
|
+
const meta = t.meta || {};
|
|
71
|
+
overviewLines.push(fmt(String(t.id), meta.title, meta.description));
|
|
72
|
+
}
|
|
73
|
+
overviewLines.push("");
|
|
74
|
+
}
|
|
75
|
+
if (resources.length) {
|
|
76
|
+
overviewLines.push(`## Sample Resources`);
|
|
77
|
+
for (const r of sample(resources)) {
|
|
78
|
+
const meta = r.meta || {};
|
|
79
|
+
overviewLines.push(fmt(String(r.id), meta.title, meta.description));
|
|
80
|
+
}
|
|
81
|
+
overviewLines.push("");
|
|
82
|
+
}
|
|
83
|
+
if (events.length) {
|
|
84
|
+
overviewLines.push(`## Sample Events`);
|
|
85
|
+
for (const e of sample(events)) {
|
|
86
|
+
const meta = e.meta || {};
|
|
87
|
+
overviewLines.push(fmt(String(e.id), meta.title, meta.description));
|
|
88
|
+
}
|
|
89
|
+
overviewLines.push("");
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
catch {
|
|
93
|
+
/* best-effort overview generation */
|
|
94
|
+
}
|
|
95
|
+
return overviewLines.join("\n");
|
|
96
|
+
}
|
|
97
|
+
async function attachCoverage(data, coverage) {
|
|
98
|
+
const attach = async (arr) => {
|
|
99
|
+
for (const el of arr) {
|
|
100
|
+
try {
|
|
101
|
+
const summary = await coverage.getSummaryForPath(el.filePath || null);
|
|
102
|
+
if (summary && typeof summary.percentage === "number") {
|
|
103
|
+
el.coverage = { percentage: summary.percentage };
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
/* best-effort coverage attachment */
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
};
|
|
111
|
+
try {
|
|
112
|
+
await attach(data.tasks || []);
|
|
113
|
+
await attach(data.resources || []);
|
|
114
|
+
await attach(data.hooks || []);
|
|
115
|
+
await attach(data.middlewares || []);
|
|
116
|
+
await attach(data.events || []);
|
|
117
|
+
}
|
|
118
|
+
catch {
|
|
119
|
+
/* best-effort coverage attachment */
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
function enrichDurableTaskMetadata(data, introspector, store) {
|
|
123
|
+
if (!Array.isArray(data.tasks)) {
|
|
124
|
+
return;
|
|
125
|
+
}
|
|
126
|
+
for (const task of data.tasks) {
|
|
127
|
+
const taskId = String(task?.id || "");
|
|
128
|
+
if (!taskId)
|
|
129
|
+
continue;
|
|
130
|
+
const isDurable = introspector.isDurableTask(taskId);
|
|
131
|
+
const dependencyIds = Array.isArray(task?.dependsOn)
|
|
132
|
+
? task.dependsOn.map((depId) => String(depId))
|
|
133
|
+
: [];
|
|
134
|
+
task.isDurable = isDurable;
|
|
135
|
+
task.durableResourceId = isDurable
|
|
136
|
+
? (0, durable_runtime_1.findDurableResourceIdFromStore)(store, taskId, dependencyIds) ||
|
|
137
|
+
introspector.getDurableResourceForTask(taskId)?.id ||
|
|
138
|
+
null
|
|
139
|
+
: null;
|
|
140
|
+
task.flowShape = null;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
async function buildDocsPagePayload(config) {
|
|
144
|
+
const { store, introspector, namespacePrefix, logger, coverage, getGraphqlSdl, } = config;
|
|
145
|
+
(0, initializeFromStore_1.initializeFromStore)(introspector, store);
|
|
146
|
+
const introspectorData = introspector.serialize();
|
|
147
|
+
enrichDurableTaskMetadata(introspectorData, introspector, store);
|
|
148
|
+
if (coverage) {
|
|
149
|
+
await attachCoverage(introspectorData, coverage);
|
|
150
|
+
}
|
|
151
|
+
const docsContent = await readDocsContent();
|
|
152
|
+
const runnerDevMd = await readRunnerDevCompactGuide();
|
|
153
|
+
let graphqlSdl;
|
|
154
|
+
try {
|
|
155
|
+
graphqlSdl = getGraphqlSdl?.();
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
logger?.warn?.("Failed to generate GraphQL SDL for docs payload");
|
|
159
|
+
}
|
|
160
|
+
return {
|
|
161
|
+
mode: config.mode ?? "live",
|
|
162
|
+
namespacePrefix,
|
|
163
|
+
introspectorData,
|
|
164
|
+
runnerFrameworkMd: docsContent.minimalMd,
|
|
165
|
+
runnerDevMd,
|
|
166
|
+
docsContent,
|
|
167
|
+
projectOverviewMd: buildProjectOverviewMarkdown(introspector),
|
|
168
|
+
graphqlSdl,
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=docsPayload.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docsPayload.js","sourceRoot":"","sources":["../../src/resources/docsPayload.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
export interface DocsBuildEntry {
|
|
2
|
+
file: string;
|
|
3
|
+
css?: string[];
|
|
4
|
+
}
|
|
5
|
+
export interface DocsBuildAssets {
|
|
6
|
+
uiDir: string;
|
|
7
|
+
entry: DocsBuildEntry;
|
|
8
|
+
}
|
|
9
|
+
export interface DocsUiRuntimeConfig {
|
|
10
|
+
apiUrl?: string;
|
|
11
|
+
}
|
|
12
|
+
export interface StandaloneDocsHtmlOptions {
|
|
13
|
+
uiDir: string;
|
|
14
|
+
entry: DocsBuildEntry;
|
|
15
|
+
payload: unknown;
|
|
16
|
+
title?: string;
|
|
17
|
+
}
|
|
18
|
+
export declare function renderDocsHtml(entry: DocsBuildEntry, options?: {
|
|
19
|
+
assetPrefix?: string;
|
|
20
|
+
faviconHref?: string;
|
|
21
|
+
snapshotPath?: string;
|
|
22
|
+
}): string;
|
|
23
|
+
export declare function applyDocsUiRuntimeReplacements(source: string, config?: DocsUiRuntimeConfig): string;
|
|
24
|
+
export declare function renderStandaloneDocsHtml(options: StandaloneDocsHtmlOptions): Promise<string>;
|
|
25
|
+
export declare function copyDocsUiAssetsForExport(sourceDir: string, targetDir: string, runtimeConfig?: DocsUiRuntimeConfig): Promise<void>;
|
|
26
|
+
export declare function readDocsBuildEntry(uiDir: string): Promise<DocsBuildEntry>;
|
|
27
|
+
export declare function resolveDocsBuildAssets(): Promise<DocsBuildAssets>;
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.renderDocsHtml = renderDocsHtml;
|
|
7
|
+
exports.applyDocsUiRuntimeReplacements = applyDocsUiRuntimeReplacements;
|
|
8
|
+
exports.renderStandaloneDocsHtml = renderStandaloneDocsHtml;
|
|
9
|
+
exports.copyDocsUiAssetsForExport = copyDocsUiAssetsForExport;
|
|
10
|
+
exports.readDocsBuildEntry = readDocsBuildEntry;
|
|
11
|
+
exports.resolveDocsBuildAssets = resolveDocsBuildAssets;
|
|
12
|
+
const node_fs_1 = __importDefault(require("node:fs"));
|
|
13
|
+
const promises_1 = __importDefault(require("node:fs/promises"));
|
|
14
|
+
const node_path_1 = __importDefault(require("node:path"));
|
|
15
|
+
function normalizeAssetHref(prefix, assetPath) {
|
|
16
|
+
const cleanPrefix = prefix.length > 0 ? `${prefix.replace(/\/+$/, "")}/` : "";
|
|
17
|
+
return `${cleanPrefix}${assetPath.replace(/^\/+/, "")}`;
|
|
18
|
+
}
|
|
19
|
+
function renderDocsHtml(entry, options) {
|
|
20
|
+
const assetPrefix = options?.assetPrefix ?? "/";
|
|
21
|
+
const faviconHref = options?.faviconHref ?? "/docs/favicon.ico";
|
|
22
|
+
const stylesheetHrefs = Array.isArray(entry.css)
|
|
23
|
+
? entry.css.map((href) => normalizeAssetHref(assetPrefix, href))
|
|
24
|
+
: [];
|
|
25
|
+
const moduleScriptHref = normalizeAssetHref(assetPrefix, entry.file);
|
|
26
|
+
const styles = stylesheetHrefs
|
|
27
|
+
.map((href) => `<link rel="stylesheet" href="${href}">`)
|
|
28
|
+
.join("");
|
|
29
|
+
const snapshotPath = options?.snapshotPath;
|
|
30
|
+
const moduleBootstrap = (() => {
|
|
31
|
+
const bootstrapData = JSON.stringify({
|
|
32
|
+
snapshotPath,
|
|
33
|
+
moduleScriptHref,
|
|
34
|
+
});
|
|
35
|
+
return `<script>(function(){var config=${bootstrapData};if(window.location.protocol==="file:"){document.body.innerHTML='<div style="min-height:100vh;display:flex;align-items:center;justify-content:center;padding:32px;background:#0f172a;color:#e2e8f0;font-family:ui-sans-serif,system-ui,sans-serif;"><div style="max-width:720px;background:#111827;border:1px solid #334155;border-radius:18px;padding:28px;box-shadow:0 24px 60px rgba(15,23,42,0.35);"><div style="font-size:12px;letter-spacing:0.12em;text-transform:uppercase;color:#93c5fd;margin-bottom:12px;">Runner-Dev Docs</div><h1 style="margin:0 0 12px;font-size:28px;line-height:1.2;">This page expects the Runner-Dev server</h1><p style="margin:0;line-height:1.6;color:#cbd5e1;">The live docs shell uses browser modules and runtime endpoints, so open it through the running Runner-Dev server instead of <code style="background:#0f172a;padding:2px 6px;border-radius:6px;color:#f8fafc;">file://</code>.</p></div></div>';return;}if(config.snapshotPath){window.__DOCS_SNAPSHOT_PATH__=config.snapshotPath;}var script=document.createElement("script");script.type="module";script.src=config.moduleScriptHref;document.body.appendChild(script);})();</script>`;
|
|
36
|
+
})();
|
|
37
|
+
return `<!DOCTYPE html><html><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Runner Dev Docs</title><link rel="icon" href="${faviconHref}" type="image/x-icon"/>${styles}</head><body><div id="root"></div>${moduleBootstrap}</body></html>`;
|
|
38
|
+
}
|
|
39
|
+
function applyDocsUiRuntimeReplacements(source, config = {}) {
|
|
40
|
+
const replacements = [
|
|
41
|
+
["__API_URL__", config.apiUrl ?? ""],
|
|
42
|
+
];
|
|
43
|
+
let transformed = source;
|
|
44
|
+
for (const [token, value] of replacements) {
|
|
45
|
+
transformed = transformed.split(token).join(JSON.stringify(value));
|
|
46
|
+
}
|
|
47
|
+
return transformed;
|
|
48
|
+
}
|
|
49
|
+
function escapeInlineScriptContent(value) {
|
|
50
|
+
return value.replace(/<\/script/gi, "<\\/script");
|
|
51
|
+
}
|
|
52
|
+
function escapeJsonForInlineScript(value) {
|
|
53
|
+
return JSON.stringify(value)
|
|
54
|
+
.replace(/</g, "\\u003c")
|
|
55
|
+
.replace(/\u2028/g, "\\u2028")
|
|
56
|
+
.replace(/\u2029/g, "\\u2029");
|
|
57
|
+
}
|
|
58
|
+
async function getInlineFaviconHref(uiDir) {
|
|
59
|
+
const faviconPath = node_path_1.default.join(uiDir, "docs", "favicon.ico");
|
|
60
|
+
try {
|
|
61
|
+
const buffer = await promises_1.default.readFile(faviconPath);
|
|
62
|
+
return `data:image/x-icon;base64,${buffer.toString("base64")}`;
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
async function renderStandaloneDocsHtml(options) {
|
|
69
|
+
const [cssSources, jsSource, faviconHref] = await Promise.all([
|
|
70
|
+
Promise.all((options.entry.css ?? []).map((href) => promises_1.default.readFile(node_path_1.default.join(options.uiDir, href), "utf8"))),
|
|
71
|
+
promises_1.default.readFile(node_path_1.default.join(options.uiDir, options.entry.file), "utf8"),
|
|
72
|
+
getInlineFaviconHref(options.uiDir),
|
|
73
|
+
]);
|
|
74
|
+
const css = cssSources.join("\n");
|
|
75
|
+
const js = escapeInlineScriptContent(applyDocsUiRuntimeReplacements(jsSource, { apiUrl: "" }).replace(/\n\/\/# sourceMappingURL=.*$/u, ""));
|
|
76
|
+
const payloadJson = escapeJsonForInlineScript(options.payload);
|
|
77
|
+
const title = options.title ?? "Runner Dev Docs";
|
|
78
|
+
const faviconTag = faviconHref
|
|
79
|
+
? `<link rel="icon" href="${faviconHref}" type="image/x-icon"/>`
|
|
80
|
+
: "";
|
|
81
|
+
return `<!DOCTYPE html><html><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>${title}</title>${faviconTag}<style>${css}</style></head><body><div id="root"></div><script>window.__DOCS_PROPS__=${payloadJson};</script><script type="module">${js}</script></body></html>`;
|
|
82
|
+
}
|
|
83
|
+
async function copyDocsUiAssetsForExport(sourceDir, targetDir, runtimeConfig = {}) {
|
|
84
|
+
await promises_1.default.mkdir(targetDir, { recursive: true });
|
|
85
|
+
const entries = await promises_1.default.readdir(sourceDir, { withFileTypes: true });
|
|
86
|
+
for (const entry of entries) {
|
|
87
|
+
const sourcePath = node_path_1.default.join(sourceDir, entry.name);
|
|
88
|
+
const targetPath = node_path_1.default.join(targetDir, entry.name);
|
|
89
|
+
if (entry.isDirectory()) {
|
|
90
|
+
await copyDocsUiAssetsForExport(sourcePath, targetPath, runtimeConfig);
|
|
91
|
+
continue;
|
|
92
|
+
}
|
|
93
|
+
if (entry.isFile() && node_path_1.default.extname(entry.name) === ".js") {
|
|
94
|
+
const content = await promises_1.default.readFile(sourcePath, "utf8");
|
|
95
|
+
await promises_1.default.writeFile(targetPath, applyDocsUiRuntimeReplacements(content, runtimeConfig), "utf8");
|
|
96
|
+
continue;
|
|
97
|
+
}
|
|
98
|
+
await promises_1.default.copyFile(sourcePath, targetPath);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
async function readDocsBuildEntry(uiDir) {
|
|
102
|
+
let manifestRaw;
|
|
103
|
+
const manifestPathVite = node_path_1.default.resolve(uiDir, ".vite/manifest.json");
|
|
104
|
+
try {
|
|
105
|
+
manifestRaw = await promises_1.default.readFile(manifestPathVite, "utf8");
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
/* fallback below */
|
|
109
|
+
}
|
|
110
|
+
if (!manifestRaw) {
|
|
111
|
+
const manifestPath = node_path_1.default.resolve(uiDir, "manifest.json");
|
|
112
|
+
manifestRaw = await promises_1.default.readFile(manifestPath, "utf8");
|
|
113
|
+
}
|
|
114
|
+
const manifest = JSON.parse(manifestRaw);
|
|
115
|
+
let entry = manifest["docs"] || manifest["src/hydrate-docs.tsx"];
|
|
116
|
+
if (!entry) {
|
|
117
|
+
entry = Object.values(manifest).find((item) => item && item.isEntry);
|
|
118
|
+
}
|
|
119
|
+
if (!entry?.file) {
|
|
120
|
+
throw new Error(`Docs UI manifest in '${uiDir}' does not contain a valid docs entry.`);
|
|
121
|
+
}
|
|
122
|
+
return {
|
|
123
|
+
file: String(entry.file),
|
|
124
|
+
css: Array.isArray(entry.css)
|
|
125
|
+
? entry.css.map((href) => String(href))
|
|
126
|
+
: [],
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
async function resolveDocsBuildAssets() {
|
|
130
|
+
const candidateUiDirs = [node_path_1.default.resolve(__dirname, "../../dist/ui")];
|
|
131
|
+
const failures = [];
|
|
132
|
+
for (const uiDir of candidateUiDirs) {
|
|
133
|
+
if (!node_fs_1.default.existsSync(uiDir)) {
|
|
134
|
+
failures.push(`${uiDir} (missing)`);
|
|
135
|
+
continue;
|
|
136
|
+
}
|
|
137
|
+
try {
|
|
138
|
+
return {
|
|
139
|
+
uiDir,
|
|
140
|
+
entry: await readDocsBuildEntry(uiDir),
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
catch (error) {
|
|
144
|
+
const reason = error instanceof Error ? error.message : "Unknown manifest error";
|
|
145
|
+
failures.push(`${uiDir} (${reason})`);
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
throw new Error(`Runner-Dev docs UI assets were not found. Expected a valid docs build in one of: ${failures.join(", ")}`);
|
|
149
|
+
}
|
|
150
|
+
//# sourceMappingURL=docsUiAssets.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docsUiAssets.js","sourceRoot":"","sources":["../../src/resources/docsUiAssets.ts"],"names":[],"mappings":"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"}
|