@stackwright-pro/mcp 0.2.0-alpha.5 → 0.2.0-alpha.52
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/LICENSE +21 -0
- package/dist/integrity.d.mts +29 -1
- package/dist/integrity.d.ts +29 -1
- package/dist/integrity.js +49 -10
- package/dist/integrity.js.map +1 -1
- package/dist/integrity.mjs +48 -10
- package/dist/integrity.mjs.map +1 -1
- package/dist/server.js +1486 -311
- package/dist/server.js.map +1 -1
- package/dist/server.mjs +1504 -313
- package/dist/server.mjs.map +1 -1
- package/dist/tools/type-schemas.d.mts +51 -0
- package/dist/tools/type-schemas.d.ts +51 -0
- package/dist/tools/type-schemas.js +120 -0
- package/dist/tools/type-schemas.js.map +1 -0
- package/dist/tools/type-schemas.mjs +94 -0
- package/dist/tools/type-schemas.mjs.map +1 -0
- package/package.json +17 -8
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Type Schemas Tool — "Sinks Not Pipes"
|
|
5
|
+
*
|
|
6
|
+
* Exposes a human-readable summary of available @stackwright-pro/types schemas.
|
|
7
|
+
* The foreman uses this for schema-based routing: "which otter owns this domain?"
|
|
8
|
+
* instead of hardcoded capability descriptions in the prompt.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Schema summary returned by the tool and written to .stackwright/type-schemas.json
|
|
13
|
+
*/
|
|
14
|
+
interface TypeSchemaSummary {
|
|
15
|
+
version: '1.0';
|
|
16
|
+
generatedAt: string;
|
|
17
|
+
domains: {
|
|
18
|
+
workflow: {
|
|
19
|
+
description: string;
|
|
20
|
+
schemas: string[];
|
|
21
|
+
otter: string;
|
|
22
|
+
artifactKey: string;
|
|
23
|
+
};
|
|
24
|
+
auth: {
|
|
25
|
+
description: string;
|
|
26
|
+
schemas: string[];
|
|
27
|
+
otter: string;
|
|
28
|
+
artifactKey: string;
|
|
29
|
+
};
|
|
30
|
+
openapi: {
|
|
31
|
+
description: string;
|
|
32
|
+
interfaces: string[];
|
|
33
|
+
otter: string;
|
|
34
|
+
artifactKey: string;
|
|
35
|
+
};
|
|
36
|
+
pulse: {
|
|
37
|
+
description: string;
|
|
38
|
+
interfaces: string[];
|
|
39
|
+
note: string;
|
|
40
|
+
};
|
|
41
|
+
enterprise: {
|
|
42
|
+
description: string;
|
|
43
|
+
interfaces: string[];
|
|
44
|
+
note: string;
|
|
45
|
+
};
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
declare function buildTypeSchemaSummary(): TypeSchemaSummary;
|
|
49
|
+
declare function registerTypeSchemasTool(server: McpServer): void;
|
|
50
|
+
|
|
51
|
+
export { type TypeSchemaSummary, buildTypeSchemaSummary, registerTypeSchemasTool };
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Type Schemas Tool — "Sinks Not Pipes"
|
|
5
|
+
*
|
|
6
|
+
* Exposes a human-readable summary of available @stackwright-pro/types schemas.
|
|
7
|
+
* The foreman uses this for schema-based routing: "which otter owns this domain?"
|
|
8
|
+
* instead of hardcoded capability descriptions in the prompt.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Schema summary returned by the tool and written to .stackwright/type-schemas.json
|
|
13
|
+
*/
|
|
14
|
+
interface TypeSchemaSummary {
|
|
15
|
+
version: '1.0';
|
|
16
|
+
generatedAt: string;
|
|
17
|
+
domains: {
|
|
18
|
+
workflow: {
|
|
19
|
+
description: string;
|
|
20
|
+
schemas: string[];
|
|
21
|
+
otter: string;
|
|
22
|
+
artifactKey: string;
|
|
23
|
+
};
|
|
24
|
+
auth: {
|
|
25
|
+
description: string;
|
|
26
|
+
schemas: string[];
|
|
27
|
+
otter: string;
|
|
28
|
+
artifactKey: string;
|
|
29
|
+
};
|
|
30
|
+
openapi: {
|
|
31
|
+
description: string;
|
|
32
|
+
interfaces: string[];
|
|
33
|
+
otter: string;
|
|
34
|
+
artifactKey: string;
|
|
35
|
+
};
|
|
36
|
+
pulse: {
|
|
37
|
+
description: string;
|
|
38
|
+
interfaces: string[];
|
|
39
|
+
note: string;
|
|
40
|
+
};
|
|
41
|
+
enterprise: {
|
|
42
|
+
description: string;
|
|
43
|
+
interfaces: string[];
|
|
44
|
+
note: string;
|
|
45
|
+
};
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
declare function buildTypeSchemaSummary(): TypeSchemaSummary;
|
|
49
|
+
declare function registerTypeSchemasTool(server: McpServer): void;
|
|
50
|
+
|
|
51
|
+
export { type TypeSchemaSummary, buildTypeSchemaSummary, registerTypeSchemasTool };
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/tools/type-schemas.ts
|
|
21
|
+
var type_schemas_exports = {};
|
|
22
|
+
__export(type_schemas_exports, {
|
|
23
|
+
buildTypeSchemaSummary: () => buildTypeSchemaSummary,
|
|
24
|
+
registerTypeSchemasTool: () => registerTypeSchemasTool
|
|
25
|
+
});
|
|
26
|
+
module.exports = __toCommonJS(type_schemas_exports);
|
|
27
|
+
var import_zod = require("zod");
|
|
28
|
+
function buildTypeSchemaSummary() {
|
|
29
|
+
return {
|
|
30
|
+
version: "1.0",
|
|
31
|
+
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
|
32
|
+
domains: {
|
|
33
|
+
workflow: {
|
|
34
|
+
description: "Workflow DSL \u2014 step definitions, auth blocks, field types, conditions",
|
|
35
|
+
schemas: [
|
|
36
|
+
"WorkflowFileSchema",
|
|
37
|
+
"WorkflowDefinitionSchema",
|
|
38
|
+
"WorkflowStepSchema",
|
|
39
|
+
"WorkflowStepTypeSchema",
|
|
40
|
+
"WorkflowFieldSchema",
|
|
41
|
+
"WorkflowActionSchema",
|
|
42
|
+
"WorkflowAuthSchema",
|
|
43
|
+
"WorkflowThemeSchema",
|
|
44
|
+
"TransitionConditionSchema",
|
|
45
|
+
"PersistenceSchema"
|
|
46
|
+
],
|
|
47
|
+
otter: "stackwright-pro-workflow-otter",
|
|
48
|
+
artifactKey: "workflowConfig"
|
|
49
|
+
},
|
|
50
|
+
auth: {
|
|
51
|
+
description: "Authentication providers \u2014 PKI/CAC, OIDC, RBAC configuration",
|
|
52
|
+
schemas: [
|
|
53
|
+
"authConfigSchema",
|
|
54
|
+
"pkiConfigSchema",
|
|
55
|
+
"oidcConfigSchema",
|
|
56
|
+
"rbacConfigSchema",
|
|
57
|
+
"componentAuthSchema",
|
|
58
|
+
"authUserSchema",
|
|
59
|
+
"authSessionSchema"
|
|
60
|
+
],
|
|
61
|
+
otter: "stackwright-pro-auth-otter",
|
|
62
|
+
artifactKey: "authConfig"
|
|
63
|
+
},
|
|
64
|
+
openapi: {
|
|
65
|
+
description: "OpenAPI spec integration \u2014 collection config, endpoint filters, actions",
|
|
66
|
+
interfaces: [
|
|
67
|
+
"OpenAPIConfig",
|
|
68
|
+
"ActionConfig",
|
|
69
|
+
"EndpointFilter",
|
|
70
|
+
"ApprovedSpec",
|
|
71
|
+
"PrebuildSecurityConfig",
|
|
72
|
+
"SiteConfig",
|
|
73
|
+
"ValidationResult"
|
|
74
|
+
],
|
|
75
|
+
otter: "stackwright-pro-api-otter",
|
|
76
|
+
artifactKey: "apiConfig"
|
|
77
|
+
},
|
|
78
|
+
pulse: {
|
|
79
|
+
description: "Real-time data polling \u2014 source-agnostic polling options and states",
|
|
80
|
+
interfaces: ["PulseOptions", "PulseMeta", "PulseState"],
|
|
81
|
+
note: "React-bound types (PulseProps, PulseIndicatorProps) remain in @stackwright-pro/pulse"
|
|
82
|
+
},
|
|
83
|
+
enterprise: {
|
|
84
|
+
description: "Enterprise collection access \u2014 multi-tenant provider extension",
|
|
85
|
+
interfaces: [
|
|
86
|
+
"EnterpriseCollectionProvider",
|
|
87
|
+
"CollectionProvider",
|
|
88
|
+
"CollectionEntry",
|
|
89
|
+
"CollectionListOptions",
|
|
90
|
+
"CollectionListResult",
|
|
91
|
+
"TenantFilter",
|
|
92
|
+
"Collection"
|
|
93
|
+
],
|
|
94
|
+
note: "CollectionProvider, CollectionEntry, CollectionListOptions, and CollectionListResult are re-exported from @stackwright/types (^1.5.0). EnterpriseCollectionProvider, TenantFilter, and Collection are Pro-only extensions."
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
function registerTypeSchemasTool(server) {
|
|
100
|
+
server.tool(
|
|
101
|
+
"stackwright_pro_get_type_schemas",
|
|
102
|
+
"Returns a structured summary of all canonical @stackwright-pro/types schemas, organized by domain. Use this to determine which otter owns a given schema and what artifact key to expect.",
|
|
103
|
+
{
|
|
104
|
+
format: import_zod.z.enum(["full", "domains-only"]).optional().default("full").describe("full = complete summary with all fields; domains-only = just domain names")
|
|
105
|
+
},
|
|
106
|
+
async ({ format }) => {
|
|
107
|
+
const summary = buildTypeSchemaSummary();
|
|
108
|
+
const output = format === "domains-only" ? Object.keys(summary.domains) : summary;
|
|
109
|
+
return {
|
|
110
|
+
content: [{ type: "text", text: JSON.stringify(output, null, 2) }]
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
);
|
|
114
|
+
}
|
|
115
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
116
|
+
0 && (module.exports = {
|
|
117
|
+
buildTypeSchemaSummary,
|
|
118
|
+
registerTypeSchemasTool
|
|
119
|
+
});
|
|
120
|
+
//# sourceMappingURL=type-schemas.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/tools/type-schemas.ts"],"sourcesContent":["/**\n * Type Schemas Tool — \"Sinks Not Pipes\"\n *\n * Exposes a human-readable summary of available @stackwright-pro/types schemas.\n * The foreman uses this for schema-based routing: \"which otter owns this domain?\"\n * instead of hardcoded capability descriptions in the prompt.\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\n/**\n * Schema summary returned by the tool and written to .stackwright/type-schemas.json\n */\nexport interface TypeSchemaSummary {\n version: '1.0';\n generatedAt: string;\n domains: {\n workflow: {\n description: string;\n schemas: string[];\n otter: string;\n artifactKey: string;\n };\n auth: {\n description: string;\n schemas: string[];\n otter: string;\n artifactKey: string;\n };\n openapi: {\n description: string;\n interfaces: string[];\n otter: string;\n artifactKey: string;\n };\n pulse: {\n description: string;\n interfaces: string[];\n note: string;\n };\n enterprise: {\n description: string;\n interfaces: string[];\n note: string;\n };\n };\n}\n\nexport function buildTypeSchemaSummary(): TypeSchemaSummary {\n return {\n version: '1.0',\n generatedAt: new Date().toISOString(),\n domains: {\n workflow: {\n description: 'Workflow DSL — step definitions, auth blocks, field types, conditions',\n schemas: [\n 'WorkflowFileSchema',\n 'WorkflowDefinitionSchema',\n 'WorkflowStepSchema',\n 'WorkflowStepTypeSchema',\n 'WorkflowFieldSchema',\n 'WorkflowActionSchema',\n 'WorkflowAuthSchema',\n 'WorkflowThemeSchema',\n 'TransitionConditionSchema',\n 'PersistenceSchema',\n ],\n otter: 'stackwright-pro-workflow-otter',\n artifactKey: 'workflowConfig',\n },\n auth: {\n description: 'Authentication providers — PKI/CAC, OIDC, RBAC configuration',\n schemas: [\n 'authConfigSchema',\n 'pkiConfigSchema',\n 'oidcConfigSchema',\n 'rbacConfigSchema',\n 'componentAuthSchema',\n 'authUserSchema',\n 'authSessionSchema',\n ],\n otter: 'stackwright-pro-auth-otter',\n artifactKey: 'authConfig',\n },\n openapi: {\n description: 'OpenAPI spec integration — collection config, endpoint filters, actions',\n interfaces: [\n 'OpenAPIConfig',\n 'ActionConfig',\n 'EndpointFilter',\n 'ApprovedSpec',\n 'PrebuildSecurityConfig',\n 'SiteConfig',\n 'ValidationResult',\n ],\n otter: 'stackwright-pro-api-otter',\n artifactKey: 'apiConfig',\n },\n pulse: {\n description: 'Real-time data polling — source-agnostic polling options and states',\n interfaces: ['PulseOptions', 'PulseMeta', 'PulseState'],\n note: 'React-bound types (PulseProps, PulseIndicatorProps) remain in @stackwright-pro/pulse',\n },\n enterprise: {\n description: 'Enterprise collection access — multi-tenant provider extension',\n interfaces: [\n 'EnterpriseCollectionProvider',\n 'CollectionProvider',\n 'CollectionEntry',\n 'CollectionListOptions',\n 'CollectionListResult',\n 'TenantFilter',\n 'Collection',\n ],\n note: 'CollectionProvider, CollectionEntry, CollectionListOptions, and CollectionListResult are re-exported from @stackwright/types (^1.5.0). EnterpriseCollectionProvider, TenantFilter, and Collection are Pro-only extensions.',\n },\n },\n };\n}\n\nexport function registerTypeSchemasTool(server: McpServer): void {\n server.tool(\n 'stackwright_pro_get_type_schemas',\n 'Returns a structured summary of all canonical @stackwright-pro/types schemas, organized by domain. Use this to determine which otter owns a given schema and what artifact key to expect.',\n {\n format: z\n .enum(['full', 'domains-only'])\n .optional()\n .default('full')\n .describe('full = complete summary with all fields; domains-only = just domain names'),\n },\n async ({ format }) => {\n const summary = buildTypeSchemaSummary();\n const output = format === 'domains-only' ? Object.keys(summary.domains) : summary;\n return {\n content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],\n };\n }\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,iBAAkB;AAwCX,SAAS,yBAA4C;AAC1D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,SAAS;AAAA,MACP,UAAU;AAAA,QACR,aAAa;AAAA,QACb,SAAS;AAAA,UACP;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,MAAM;AAAA,QACJ,aAAa;AAAA,QACb,SAAS;AAAA,UACP;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,SAAS;AAAA,QACP,aAAa;AAAA,QACb,YAAY;AAAA,UACV;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,OAAO;AAAA,QACL,aAAa;AAAA,QACb,YAAY,CAAC,gBAAgB,aAAa,YAAY;AAAA,QACtD,MAAM;AAAA,MACR;AAAA,MACA,YAAY;AAAA,QACV,aAAa;AAAA,QACb,YAAY;AAAA,UACV;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,wBAAwB,QAAyB;AAC/D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,QAAQ,aACL,KAAK,CAAC,QAAQ,cAAc,CAAC,EAC7B,SAAS,EACT,QAAQ,MAAM,EACd,SAAS,2EAA2E;AAAA,IACzF;AAAA,IACA,OAAO,EAAE,OAAO,MAAM;AACpB,YAAM,UAAU,uBAAuB;AACvC,YAAM,SAAS,WAAW,iBAAiB,OAAO,KAAK,QAAQ,OAAO,IAAI;AAC1E,aAAO;AAAA,QACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,CAAC;AAAA,MACnE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// src/tools/type-schemas.ts
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
function buildTypeSchemaSummary() {
|
|
4
|
+
return {
|
|
5
|
+
version: "1.0",
|
|
6
|
+
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
|
7
|
+
domains: {
|
|
8
|
+
workflow: {
|
|
9
|
+
description: "Workflow DSL \u2014 step definitions, auth blocks, field types, conditions",
|
|
10
|
+
schemas: [
|
|
11
|
+
"WorkflowFileSchema",
|
|
12
|
+
"WorkflowDefinitionSchema",
|
|
13
|
+
"WorkflowStepSchema",
|
|
14
|
+
"WorkflowStepTypeSchema",
|
|
15
|
+
"WorkflowFieldSchema",
|
|
16
|
+
"WorkflowActionSchema",
|
|
17
|
+
"WorkflowAuthSchema",
|
|
18
|
+
"WorkflowThemeSchema",
|
|
19
|
+
"TransitionConditionSchema",
|
|
20
|
+
"PersistenceSchema"
|
|
21
|
+
],
|
|
22
|
+
otter: "stackwright-pro-workflow-otter",
|
|
23
|
+
artifactKey: "workflowConfig"
|
|
24
|
+
},
|
|
25
|
+
auth: {
|
|
26
|
+
description: "Authentication providers \u2014 PKI/CAC, OIDC, RBAC configuration",
|
|
27
|
+
schemas: [
|
|
28
|
+
"authConfigSchema",
|
|
29
|
+
"pkiConfigSchema",
|
|
30
|
+
"oidcConfigSchema",
|
|
31
|
+
"rbacConfigSchema",
|
|
32
|
+
"componentAuthSchema",
|
|
33
|
+
"authUserSchema",
|
|
34
|
+
"authSessionSchema"
|
|
35
|
+
],
|
|
36
|
+
otter: "stackwright-pro-auth-otter",
|
|
37
|
+
artifactKey: "authConfig"
|
|
38
|
+
},
|
|
39
|
+
openapi: {
|
|
40
|
+
description: "OpenAPI spec integration \u2014 collection config, endpoint filters, actions",
|
|
41
|
+
interfaces: [
|
|
42
|
+
"OpenAPIConfig",
|
|
43
|
+
"ActionConfig",
|
|
44
|
+
"EndpointFilter",
|
|
45
|
+
"ApprovedSpec",
|
|
46
|
+
"PrebuildSecurityConfig",
|
|
47
|
+
"SiteConfig",
|
|
48
|
+
"ValidationResult"
|
|
49
|
+
],
|
|
50
|
+
otter: "stackwright-pro-api-otter",
|
|
51
|
+
artifactKey: "apiConfig"
|
|
52
|
+
},
|
|
53
|
+
pulse: {
|
|
54
|
+
description: "Real-time data polling \u2014 source-agnostic polling options and states",
|
|
55
|
+
interfaces: ["PulseOptions", "PulseMeta", "PulseState"],
|
|
56
|
+
note: "React-bound types (PulseProps, PulseIndicatorProps) remain in @stackwright-pro/pulse"
|
|
57
|
+
},
|
|
58
|
+
enterprise: {
|
|
59
|
+
description: "Enterprise collection access \u2014 multi-tenant provider extension",
|
|
60
|
+
interfaces: [
|
|
61
|
+
"EnterpriseCollectionProvider",
|
|
62
|
+
"CollectionProvider",
|
|
63
|
+
"CollectionEntry",
|
|
64
|
+
"CollectionListOptions",
|
|
65
|
+
"CollectionListResult",
|
|
66
|
+
"TenantFilter",
|
|
67
|
+
"Collection"
|
|
68
|
+
],
|
|
69
|
+
note: "CollectionProvider, CollectionEntry, CollectionListOptions, and CollectionListResult are re-exported from @stackwright/types (^1.5.0). EnterpriseCollectionProvider, TenantFilter, and Collection are Pro-only extensions."
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
function registerTypeSchemasTool(server) {
|
|
75
|
+
server.tool(
|
|
76
|
+
"stackwright_pro_get_type_schemas",
|
|
77
|
+
"Returns a structured summary of all canonical @stackwright-pro/types schemas, organized by domain. Use this to determine which otter owns a given schema and what artifact key to expect.",
|
|
78
|
+
{
|
|
79
|
+
format: z.enum(["full", "domains-only"]).optional().default("full").describe("full = complete summary with all fields; domains-only = just domain names")
|
|
80
|
+
},
|
|
81
|
+
async ({ format }) => {
|
|
82
|
+
const summary = buildTypeSchemaSummary();
|
|
83
|
+
const output = format === "domains-only" ? Object.keys(summary.domains) : summary;
|
|
84
|
+
return {
|
|
85
|
+
content: [{ type: "text", text: JSON.stringify(output, null, 2) }]
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
);
|
|
89
|
+
}
|
|
90
|
+
export {
|
|
91
|
+
buildTypeSchemaSummary,
|
|
92
|
+
registerTypeSchemasTool
|
|
93
|
+
};
|
|
94
|
+
//# sourceMappingURL=type-schemas.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/tools/type-schemas.ts"],"sourcesContent":["/**\n * Type Schemas Tool — \"Sinks Not Pipes\"\n *\n * Exposes a human-readable summary of available @stackwright-pro/types schemas.\n * The foreman uses this for schema-based routing: \"which otter owns this domain?\"\n * instead of hardcoded capability descriptions in the prompt.\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\n\n/**\n * Schema summary returned by the tool and written to .stackwright/type-schemas.json\n */\nexport interface TypeSchemaSummary {\n version: '1.0';\n generatedAt: string;\n domains: {\n workflow: {\n description: string;\n schemas: string[];\n otter: string;\n artifactKey: string;\n };\n auth: {\n description: string;\n schemas: string[];\n otter: string;\n artifactKey: string;\n };\n openapi: {\n description: string;\n interfaces: string[];\n otter: string;\n artifactKey: string;\n };\n pulse: {\n description: string;\n interfaces: string[];\n note: string;\n };\n enterprise: {\n description: string;\n interfaces: string[];\n note: string;\n };\n };\n}\n\nexport function buildTypeSchemaSummary(): TypeSchemaSummary {\n return {\n version: '1.0',\n generatedAt: new Date().toISOString(),\n domains: {\n workflow: {\n description: 'Workflow DSL — step definitions, auth blocks, field types, conditions',\n schemas: [\n 'WorkflowFileSchema',\n 'WorkflowDefinitionSchema',\n 'WorkflowStepSchema',\n 'WorkflowStepTypeSchema',\n 'WorkflowFieldSchema',\n 'WorkflowActionSchema',\n 'WorkflowAuthSchema',\n 'WorkflowThemeSchema',\n 'TransitionConditionSchema',\n 'PersistenceSchema',\n ],\n otter: 'stackwright-pro-workflow-otter',\n artifactKey: 'workflowConfig',\n },\n auth: {\n description: 'Authentication providers — PKI/CAC, OIDC, RBAC configuration',\n schemas: [\n 'authConfigSchema',\n 'pkiConfigSchema',\n 'oidcConfigSchema',\n 'rbacConfigSchema',\n 'componentAuthSchema',\n 'authUserSchema',\n 'authSessionSchema',\n ],\n otter: 'stackwright-pro-auth-otter',\n artifactKey: 'authConfig',\n },\n openapi: {\n description: 'OpenAPI spec integration — collection config, endpoint filters, actions',\n interfaces: [\n 'OpenAPIConfig',\n 'ActionConfig',\n 'EndpointFilter',\n 'ApprovedSpec',\n 'PrebuildSecurityConfig',\n 'SiteConfig',\n 'ValidationResult',\n ],\n otter: 'stackwright-pro-api-otter',\n artifactKey: 'apiConfig',\n },\n pulse: {\n description: 'Real-time data polling — source-agnostic polling options and states',\n interfaces: ['PulseOptions', 'PulseMeta', 'PulseState'],\n note: 'React-bound types (PulseProps, PulseIndicatorProps) remain in @stackwright-pro/pulse',\n },\n enterprise: {\n description: 'Enterprise collection access — multi-tenant provider extension',\n interfaces: [\n 'EnterpriseCollectionProvider',\n 'CollectionProvider',\n 'CollectionEntry',\n 'CollectionListOptions',\n 'CollectionListResult',\n 'TenantFilter',\n 'Collection',\n ],\n note: 'CollectionProvider, CollectionEntry, CollectionListOptions, and CollectionListResult are re-exported from @stackwright/types (^1.5.0). EnterpriseCollectionProvider, TenantFilter, and Collection are Pro-only extensions.',\n },\n },\n };\n}\n\nexport function registerTypeSchemasTool(server: McpServer): void {\n server.tool(\n 'stackwright_pro_get_type_schemas',\n 'Returns a structured summary of all canonical @stackwright-pro/types schemas, organized by domain. Use this to determine which otter owns a given schema and what artifact key to expect.',\n {\n format: z\n .enum(['full', 'domains-only'])\n .optional()\n .default('full')\n .describe('full = complete summary with all fields; domains-only = just domain names'),\n },\n async ({ format }) => {\n const summary = buildTypeSchemaSummary();\n const output = format === 'domains-only' ? Object.keys(summary.domains) : summary;\n return {\n content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],\n };\n }\n );\n}\n"],"mappings":";AAQA,SAAS,SAAS;AAwCX,SAAS,yBAA4C;AAC1D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,SAAS;AAAA,MACP,UAAU;AAAA,QACR,aAAa;AAAA,QACb,SAAS;AAAA,UACP;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,MAAM;AAAA,QACJ,aAAa;AAAA,QACb,SAAS;AAAA,UACP;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,SAAS;AAAA,QACP,aAAa;AAAA,QACb,YAAY;AAAA,UACV;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,OAAO;AAAA,QACL,aAAa;AAAA,QACb,YAAY,CAAC,gBAAgB,aAAa,YAAY;AAAA,QACtD,MAAM;AAAA,MACR;AAAA,MACA,YAAY;AAAA,QACV,aAAa;AAAA,QACb,YAAY;AAAA,UACV;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,wBAAwB,QAAyB;AAC/D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,QAAQ,EACL,KAAK,CAAC,QAAQ,cAAc,CAAC,EAC7B,SAAS,EACT,QAAQ,MAAM,EACd,SAAS,2EAA2E;AAAA,IACzF;AAAA,IACA,OAAO,EAAE,OAAO,MAAM;AACpB,YAAM,UAAU,uBAAuB;AACvC,YAAM,SAAS,WAAW,iBAAiB,OAAO,KAAK,QAAQ,OAAO,IAAI;AAC1E,aAAO;AAAA,QACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,CAAC;AAAA,MACnE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
|
package/package.json
CHANGED
|
@@ -1,20 +1,24 @@
|
|
|
1
1
|
{
|
|
2
2
|
"dependencies": {
|
|
3
3
|
"@modelcontextprotocol/sdk": "^1.10.0",
|
|
4
|
-
"zod": "^4.3
|
|
5
|
-
"@stackwright-pro/
|
|
4
|
+
"zod": "^4.4.3",
|
|
5
|
+
"@stackwright-pro/types": "0.2.0-alpha.8",
|
|
6
|
+
"@stackwright-pro/cli-data-explorer": "2.0.0-alpha.9"
|
|
6
7
|
},
|
|
7
8
|
"devDependencies": {
|
|
8
|
-
"@types/node": "^
|
|
9
|
-
"tsup": "^8.5.
|
|
10
|
-
"typescript": "^
|
|
11
|
-
"vitest": "^4.
|
|
9
|
+
"@types/node": "^25.9.1",
|
|
10
|
+
"tsup": "^8.5.1",
|
|
11
|
+
"typescript": "^6.0.3",
|
|
12
|
+
"vitest": "^4.1.7"
|
|
12
13
|
},
|
|
13
14
|
"name": "@stackwright-pro/mcp",
|
|
14
|
-
"version": "0.2.0-alpha.
|
|
15
|
+
"version": "0.2.0-alpha.52",
|
|
15
16
|
"description": "MCP tools for Stackwright Pro - Data Explorer, Security, ISR, and Dashboard generation",
|
|
16
|
-
"license": "
|
|
17
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
17
18
|
"main": "./dist/server.js",
|
|
19
|
+
"bin": {
|
|
20
|
+
"stackwright-pro-mcp": "./dist/server.js"
|
|
21
|
+
},
|
|
18
22
|
"module": "./dist/server.mjs",
|
|
19
23
|
"types": "./dist/server.d.ts",
|
|
20
24
|
"exports": {
|
|
@@ -27,6 +31,11 @@
|
|
|
27
31
|
"types": "./dist/integrity.d.ts",
|
|
28
32
|
"import": "./dist/integrity.mjs",
|
|
29
33
|
"require": "./dist/integrity.js"
|
|
34
|
+
},
|
|
35
|
+
"./type-schemas": {
|
|
36
|
+
"types": "./dist/tools/type-schemas.d.ts",
|
|
37
|
+
"import": "./dist/tools/type-schemas.mjs",
|
|
38
|
+
"require": "./dist/tools/type-schemas.js"
|
|
30
39
|
}
|
|
31
40
|
},
|
|
32
41
|
"files": [
|