@haneinfo/mcp-server 3.5.0 → 4.0.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.
Files changed (84) hide show
  1. package/README.md +177 -12
  2. package/dist/admin-access.d.ts +24 -0
  3. package/dist/admin-access.d.ts.map +1 -0
  4. package/dist/admin-access.js +54 -0
  5. package/dist/admin-access.js.map +1 -0
  6. package/dist/authenticator.d.ts +31 -0
  7. package/dist/authenticator.d.ts.map +1 -0
  8. package/dist/authenticator.js +37 -0
  9. package/dist/authenticator.js.map +1 -0
  10. package/dist/deployment-config.d.ts +67 -0
  11. package/dist/deployment-config.d.ts.map +1 -0
  12. package/dist/deployment-config.js +157 -0
  13. package/dist/deployment-config.js.map +1 -0
  14. package/dist/discovery-push.service.d.ts +11 -9
  15. package/dist/discovery-push.service.d.ts.map +1 -1
  16. package/dist/discovery-push.service.js +27 -11
  17. package/dist/discovery-push.service.js.map +1 -1
  18. package/dist/enabled-resources.d.ts +53 -0
  19. package/dist/enabled-resources.d.ts.map +1 -0
  20. package/dist/enabled-resources.js +243 -0
  21. package/dist/enabled-resources.js.map +1 -0
  22. package/dist/iam-authenticator.d.ts +29 -0
  23. package/dist/iam-authenticator.d.ts.map +1 -0
  24. package/dist/iam-authenticator.js +269 -0
  25. package/dist/iam-authenticator.js.map +1 -0
  26. package/dist/index.d.ts +10 -3
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +10 -5
  29. package/dist/index.js.map +1 -1
  30. package/dist/mcp-tool.registry.d.ts +21 -76
  31. package/dist/mcp-tool.registry.d.ts.map +1 -1
  32. package/dist/mcp-tool.registry.js +66 -240
  33. package/dist/mcp-tool.registry.js.map +1 -1
  34. package/dist/mcp.controller.d.ts +21 -5
  35. package/dist/mcp.controller.d.ts.map +1 -1
  36. package/dist/mcp.controller.js +273 -48
  37. package/dist/mcp.controller.js.map +1 -1
  38. package/dist/mcp.module.d.ts +5 -0
  39. package/dist/mcp.module.d.ts.map +1 -1
  40. package/dist/mcp.module.js +71 -8
  41. package/dist/mcp.module.js.map +1 -1
  42. package/dist/mcp.service.d.ts +31 -18
  43. package/dist/mcp.service.d.ts.map +1 -1
  44. package/dist/mcp.service.js +784 -194
  45. package/dist/mcp.service.js.map +1 -1
  46. package/dist/pg-rate-limiter.d.ts +46 -0
  47. package/dist/pg-rate-limiter.d.ts.map +1 -0
  48. package/dist/pg-rate-limiter.js +161 -0
  49. package/dist/pg-rate-limiter.js.map +1 -0
  50. package/dist/plugin.d.ts +41 -4
  51. package/dist/plugin.d.ts.map +1 -1
  52. package/dist/plugin.js +26 -14
  53. package/dist/plugin.js.map +1 -1
  54. package/dist/prm.controller.d.ts +17 -0
  55. package/dist/prm.controller.d.ts.map +1 -0
  56. package/dist/prm.controller.js +77 -0
  57. package/dist/prm.controller.js.map +1 -0
  58. package/dist/protocol-config.d.ts +36 -0
  59. package/dist/protocol-config.d.ts.map +1 -0
  60. package/dist/protocol-config.js +142 -0
  61. package/dist/protocol-config.js.map +1 -0
  62. package/dist/rate-limit-config.d.ts +25 -0
  63. package/dist/rate-limit-config.d.ts.map +1 -0
  64. package/dist/rate-limit-config.js +85 -0
  65. package/dist/rate-limit-config.js.map +1 -0
  66. package/dist/rate-limit-http.d.ts +11 -0
  67. package/dist/rate-limit-http.d.ts.map +1 -0
  68. package/dist/rate-limit-http.js +68 -0
  69. package/dist/rate-limit-http.js.map +1 -0
  70. package/dist/request-state.d.ts +14 -9
  71. package/dist/request-state.d.ts.map +1 -1
  72. package/dist/request-state.js +37 -3
  73. package/dist/request-state.js.map +1 -1
  74. package/dist/types.d.ts +24 -7
  75. package/dist/types.d.ts.map +1 -1
  76. package/dist/types.js +3 -0
  77. package/dist/types.js.map +1 -1
  78. package/dist/write-confirmation.d.ts +82 -0
  79. package/dist/write-confirmation.d.ts.map +1 -0
  80. package/dist/write-confirmation.js +207 -0
  81. package/dist/write-confirmation.js.map +1 -0
  82. package/haneinfo.plugin.json +19 -11
  83. package/package.json +23 -11
  84. package/prisma/mcp-rate-limit.prisma +34 -0
@@ -1,18 +1,20 @@
1
- import { OnApplicationBootstrap } from '@nestjs/common';
1
+ import { type OnApplicationBootstrap } from '@nestjs/common';
2
+ import { McpEnabledResources } from './enabled-resources';
2
3
  import { McpToolRegistry } from './mcp-tool.registry';
3
4
  /**
4
- * Opt-in, best-effort push of this app's tool catalog to the 023 discovery service
5
- * (dev_docs 023 §2.1, T-9700). Only apps with `DISCOVERY_PUSH_URL` + `DISCOVERY_PUSH_TOKEN`
6
- * set push anything — every other app is unaffected. Push happens once, at boot: a deploy
7
- * already restarts the process, so "push at deploy time" (the cadence 023 §2.1 calls for)
8
- * falls out of `OnApplicationBootstrap` without needing a scheduler dependency. A failed
9
- * push is logged and swallowed — the discovery catalog is a convenience directory, not a
10
- * dependency this app's own requests should ever fail on.
5
+ * Opt-in, best-effort push of this app's enabled resources and tool catalog snapshot to the 023
6
+ * discovery service (dev_docs 023 §2.1, T-9700). Only apps with `DISCOVERY_PUSH_URL` +
7
+ * `DISCOVERY_PUSH_TOKEN` set push anything — every other app is unaffected. Push happens once, at
8
+ * boot: a deploy already restarts the process, so "push at deploy time" falls out of
9
+ * `OnApplicationBootstrap` without needing a scheduler dependency. A failed push is logged and
10
+ * swallowed — the discovery catalog is a convenience directory, not a dependency this app's own
11
+ * requests should ever fail on.
11
12
  */
12
13
  export declare class DiscoveryPushService implements OnApplicationBootstrap {
13
14
  private readonly registry;
15
+ private readonly enabledResources;
14
16
  private readonly logger;
15
- constructor(registry: McpToolRegistry);
17
+ constructor(registry: McpToolRegistry, enabledResources?: McpEnabledResources);
16
18
  onApplicationBootstrap(): Promise<void>;
17
19
  }
18
20
  //# sourceMappingURL=discovery-push.service.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"discovery-push.service.d.ts","sourceRoot":"","sources":["../src/discovery-push.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;GAQG;AACH,qBACa,oBAAqB,YAAW,sBAAsB;IAGrD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAEnC,QAAQ,EAAE,eAAe;IAEhD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B9C"}
1
+ {"version":3,"file":"discovery-push.service.d.ts","sourceRoot":"","sources":["../src/discovery-push.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,sBAAsB,EAAY,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAA2B,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;GAQG;AACH,qBACa,oBAAqB,YAAW,sBAAsB;IAI/D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAG7C,QAAQ,EAAE,eAAe,EAEzB,gBAAgB,GAAE,mBAA6C;IAG5E,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;CAuC9C"}
@@ -8,23 +8,28 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
8
8
  var __metadata = (this && this.__metadata) || function (k, v) {
9
9
  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
10
  };
11
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
11
14
  var DiscoveryPushService_1;
12
15
  Object.defineProperty(exports, "__esModule", { value: true });
13
16
  exports.DiscoveryPushService = void 0;
14
17
  const common_1 = require("@nestjs/common");
18
+ const enabled_resources_1 = require("./enabled-resources");
15
19
  const mcp_tool_registry_1 = require("./mcp-tool.registry");
16
20
  /**
17
- * Opt-in, best-effort push of this app's tool catalog to the 023 discovery service
18
- * (dev_docs 023 §2.1, T-9700). Only apps with `DISCOVERY_PUSH_URL` + `DISCOVERY_PUSH_TOKEN`
19
- * set push anything — every other app is unaffected. Push happens once, at boot: a deploy
20
- * already restarts the process, so "push at deploy time" (the cadence 023 §2.1 calls for)
21
- * falls out of `OnApplicationBootstrap` without needing a scheduler dependency. A failed
22
- * push is logged and swallowed — the discovery catalog is a convenience directory, not a
23
- * dependency this app's own requests should ever fail on.
21
+ * Opt-in, best-effort push of this app's enabled resources and tool catalog snapshot to the 023
22
+ * discovery service (dev_docs 023 §2.1, T-9700). Only apps with `DISCOVERY_PUSH_URL` +
23
+ * `DISCOVERY_PUSH_TOKEN` set push anything — every other app is unaffected. Push happens once, at
24
+ * boot: a deploy already restarts the process, so "push at deploy time" falls out of
25
+ * `OnApplicationBootstrap` without needing a scheduler dependency. A failed push is logged and
26
+ * swallowed — the discovery catalog is a convenience directory, not a dependency this app's own
27
+ * requests should ever fail on.
24
28
  */
25
29
  let DiscoveryPushService = DiscoveryPushService_1 = class DiscoveryPushService {
26
- constructor(registry) {
30
+ constructor(registry, enabledResources = enabled_resources_1.EMPTY_ENABLED_RESOURCES) {
27
31
  this.registry = registry;
32
+ this.enabledResources = enabledResources;
28
33
  this.logger = new common_1.Logger(DiscoveryPushService_1.name);
29
34
  }
30
35
  async onApplicationBootstrap() {
@@ -33,11 +38,20 @@ let DiscoveryPushService = DiscoveryPushService_1 = class DiscoveryPushService {
33
38
  if (!pushUrl || !pushToken)
34
39
  return;
35
40
  const publicBaseUrl = process.env.PUBLIC_BASE_URL;
41
+ const enabled = this.enabledResources.getEnabledResources();
42
+ const resources = enabled.map((resource) => ({
43
+ kind: resource.kind,
44
+ ...(publicBaseUrl ? { endpointUrl: resource.canonicalResourceUrl } : {}),
45
+ }));
36
46
  const body = {
37
- toolCatalogSnapshot: this.registry.getCatalogSnapshot(),
47
+ resources,
48
+ toolCatalogSnapshot: this.registry.getCatalogSnapshot(enabled.map((r) => r.kind)),
38
49
  };
39
50
  if (publicBaseUrl) {
40
- body.mcpEndpointUrl = `${publicBaseUrl}/mcp`;
51
+ const employeeResource = this.enabledResources.get('employee');
52
+ if (employeeResource) {
53
+ body.mcpEndpointUrl = employeeResource.canonicalResourceUrl;
54
+ }
41
55
  body.metadataEndpointUrl = `${publicBaseUrl}/metadata/schema`;
42
56
  }
43
57
  try {
@@ -61,6 +75,8 @@ let DiscoveryPushService = DiscoveryPushService_1 = class DiscoveryPushService {
61
75
  exports.DiscoveryPushService = DiscoveryPushService;
62
76
  exports.DiscoveryPushService = DiscoveryPushService = DiscoveryPushService_1 = __decorate([
63
77
  (0, common_1.Injectable)(),
64
- __metadata("design:paramtypes", [mcp_tool_registry_1.McpToolRegistry])
78
+ __param(1, (0, common_1.Optional)()),
79
+ __metadata("design:paramtypes", [mcp_tool_registry_1.McpToolRegistry,
80
+ enabled_resources_1.McpEnabledResources])
65
81
  ], DiscoveryPushService);
66
82
  //# sourceMappingURL=discovery-push.service.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"discovery-push.service.js","sourceRoot":"","sources":["../src/discovery-push.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAA4E;AAC5E,2DAAsD;AAEtD;;;;;;;;GAQG;AAEI,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAG/B,YAA6B,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;QAFrC,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAEP,CAAC;IAE1D,KAAK,CAAC,sBAAsB;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QACnD,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;YAAE,OAAO;QAEnC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAClD,MAAM,IAAI,GAA4B;YACpC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE;SACxD,CAAC;QACF,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,cAAc,GAAG,GAAG,aAAa,MAAM,CAAC;YAC7C,IAAI,CAAC,mBAAmB,GAAG,GAAG,aAAa,kBAAkB,CAAC;QAChE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,EAAE;gBACtE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,SAAS,EAAE;gBACpF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;CACF,CAAA;AAnCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAI4B,mCAAe;GAH3C,oBAAoB,CAmChC"}
1
+ {"version":3,"file":"discovery-push.service.js","sourceRoot":"","sources":["../src/discovery-push.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA2F;AAC3F,2DAAmF;AACnF,2DAAsD;AAEtD;;;;;;;;GAQG;AAEI,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAG/B,YACmB,QAAyB,EAE1C,mBAAyD,2CAAuB;QAF/D,aAAQ,GAAR,QAAQ,CAAiB;QAEzB,qBAAgB,GAAhB,gBAAgB,CAA+C;QALjE,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAM7D,CAAC;IAEJ,KAAK,CAAC,sBAAsB;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QACnD,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;YAAE,OAAO;QAEnC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,GAA4B;YACpC,SAAS;YACT,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAClF,CAAC;QACF,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC/D,IAAI,gBAAgB,EAAE,CAAC;gBACrB,IAAI,CAAC,cAAc,GAAG,gBAAgB,CAAC,oBAAoB,CAAC;YAC9D,CAAC;YACD,IAAI,CAAC,mBAAmB,GAAG,GAAG,aAAa,kBAAkB,CAAC;QAChE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,EAAE;gBACtE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,SAAS,EAAE;gBACpF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;CACF,CAAA;AAhDY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,iBAAQ,GAAE,CAAA;qCADgB,mCAAe;QAEP,uCAAmB;GAN7C,oBAAoB,CAgDhC"}
@@ -0,0 +1,53 @@
1
+ import { type IamProfilePort } from '@haneinfo/plugin-api';
2
+ import { type McpIamDeploymentConfig } from './deployment-config';
3
+ import { type McpModuleOptions, type McpResourceKind } from './types';
4
+ /**
5
+ * Stable warning codes emitted by {@link McpEnabledResources} during boot validation and dynamic
6
+ * command scope filtering (`mcp-connector-contract.md` §1, §7.3).
7
+ */
8
+ export declare const MCP_VALIDATION_WARNING_CODES: {
9
+ readonly DEPLOYMENT_CONFIG_MISSING: "deployment_config_missing";
10
+ readonly CONNECTOR_MANIFEST_MISSING: "connector_manifest_missing";
11
+ readonly MANIFEST_INVALID: "manifest_invalid";
12
+ readonly IAM_PROFILE_MISSING: "iam_profile_missing";
13
+ readonly IAM_ISSUER_MISMATCH: "iam_issuer_mismatch";
14
+ readonly MANIFEST_ENABLED_MISMATCH: "manifest_enabled_mismatch";
15
+ readonly MANIFEST_PATH_MISMATCH: "manifest_path_mismatch";
16
+ readonly MANIFEST_CLIENT_MISMATCH: "manifest_client_mismatch";
17
+ readonly MANIFEST_COMMAND_SCOPE_UNDECLARED: "manifest_command_scope_undeclared";
18
+ readonly MANIFEST_ADMIN_MAX_AUTH_AGE_MISMATCH: "manifest_admin_max_auth_age_mismatch";
19
+ readonly IAM_ADMIN_MFA_UNSUPPORTED: "iam_admin_mfa_unsupported";
20
+ readonly MANIFEST_ADMIN_REQUIRED_SCOPE_UNDECLARED: "manifest_admin_required_scope_undeclared";
21
+ readonly MANIFEST_DYNAMIC_COMMAND_SCOPE_UNDECLARED: "manifest_dynamic_command_scope_undeclared";
22
+ };
23
+ export type McpValidationWarningCode = (typeof MCP_VALIDATION_WARNING_CODES)[keyof typeof MCP_VALIDATION_WARNING_CODES];
24
+ export interface EnabledMcpResource {
25
+ readonly kind: McpResourceKind;
26
+ readonly issuer: string;
27
+ readonly canonicalResourceUrl: string;
28
+ readonly relativePath: string;
29
+ readonly allowedClientIds: readonly string[];
30
+ readonly scopes: readonly string[];
31
+ }
32
+ /**
33
+ * Computes the single authoritative set of enabled MCP resources at startup (`1A` §8,
34
+ * `mcp-connector-contract.md` §1, §7.3). RPC, PRM, and discovery push all consult this set
35
+ * instead of reading `deployment.mcp[kind].enabled` directly.
36
+ */
37
+ export declare class McpEnabledResources {
38
+ private readonly logger;
39
+ private readonly byKind;
40
+ private readonly warnedDynamicCommands;
41
+ constructor(deployment?: McpIamDeploymentConfig, options?: McpModuleOptions, iamProfile?: Partial<IamProfilePort>);
42
+ /** Creates a silent empty instance for fallback when a controller is instantiated without DI. */
43
+ static empty(): McpEnabledResources;
44
+ isEnabled(kind: McpResourceKind): boolean;
45
+ get(kind: McpResourceKind): EnabledMcpResource | undefined;
46
+ getEnabledResources(): readonly EnabledMcpResource[];
47
+ getEnabledKinds(): readonly McpResourceKind[];
48
+ isCommandScopeAllowed(kind: McpResourceKind, scope: string): boolean;
49
+ warnDynamicCommandScopeOnce(kind: McpResourceKind, commandName: string): void;
50
+ private compute;
51
+ }
52
+ export declare const EMPTY_ENABLED_RESOURCES: McpEnabledResources;
53
+ //# sourceMappingURL=enabled-resources.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enabled-resources.d.ts","sourceRoot":"","sources":["../src/enabled-resources.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAwB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;CAc/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAEnF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AA4CD;;;;GAIG;AACH,qBACa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAC9E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqB;gBAKzD,UAAU,CAAC,EAAE,sBAAsB,EAGnC,OAAO,CAAC,EAAE,gBAAgB,EAG1B,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKtC,iGAAiG;IACjG,MAAM,CAAC,KAAK,IAAI,mBAAmB;IAUnC,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO;IAIzC,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS;IAI1D,mBAAmB,IAAI,SAAS,kBAAkB,EAAE;IAWpD,eAAe,IAAI,SAAS,eAAe,EAAE;IAI7C,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAMpE,2BAA2B,CAAC,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAU7E,OAAO,CAAC,OAAO;CA4JhB;AAED,eAAO,MAAM,uBAAuB,EAAE,mBAAiD,CAAC"}
@@ -0,0 +1,243 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ var McpEnabledResources_1;
15
+ Object.defineProperty(exports, "__esModule", { value: true });
16
+ exports.EMPTY_ENABLED_RESOURCES = exports.McpEnabledResources = exports.MCP_VALIDATION_WARNING_CODES = void 0;
17
+ const plugin_api_1 = require("@haneinfo/plugin-api");
18
+ const common_1 = require("@nestjs/common");
19
+ const deployment_config_1 = require("./deployment-config");
20
+ const types_1 = require("./types");
21
+ /**
22
+ * Stable warning codes emitted by {@link McpEnabledResources} during boot validation and dynamic
23
+ * command scope filtering (`mcp-connector-contract.md` §1, §7.3).
24
+ */
25
+ exports.MCP_VALIDATION_WARNING_CODES = {
26
+ DEPLOYMENT_CONFIG_MISSING: 'deployment_config_missing',
27
+ CONNECTOR_MANIFEST_MISSING: 'connector_manifest_missing',
28
+ MANIFEST_INVALID: 'manifest_invalid',
29
+ IAM_PROFILE_MISSING: 'iam_profile_missing',
30
+ IAM_ISSUER_MISMATCH: 'iam_issuer_mismatch',
31
+ MANIFEST_ENABLED_MISMATCH: 'manifest_enabled_mismatch',
32
+ MANIFEST_PATH_MISMATCH: 'manifest_path_mismatch',
33
+ MANIFEST_CLIENT_MISMATCH: 'manifest_client_mismatch',
34
+ MANIFEST_COMMAND_SCOPE_UNDECLARED: 'manifest_command_scope_undeclared',
35
+ MANIFEST_ADMIN_MAX_AUTH_AGE_MISMATCH: 'manifest_admin_max_auth_age_mismatch',
36
+ IAM_ADMIN_MFA_UNSUPPORTED: 'iam_admin_mfa_unsupported',
37
+ MANIFEST_ADMIN_REQUIRED_SCOPE_UNDECLARED: 'manifest_admin_required_scope_undeclared',
38
+ MANIFEST_DYNAMIC_COMMAND_SCOPE_UNDECLARED: 'manifest_dynamic_command_scope_undeclared',
39
+ };
40
+ const RESOURCE_KINDS = ['employee', 'admin'];
41
+ function matchesRelativePath(canonicalResourceUrl, relativePath) {
42
+ let parsed;
43
+ try {
44
+ parsed = new URL(canonicalResourceUrl);
45
+ }
46
+ catch {
47
+ return false;
48
+ }
49
+ if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
50
+ return false;
51
+ }
52
+ if (parsed.search.length > 0 || parsed.hash.length > 0) {
53
+ return false;
54
+ }
55
+ const pathname = parsed.pathname;
56
+ if (!relativePath.startsWith('/') || !pathname.endsWith(relativePath)) {
57
+ return false;
58
+ }
59
+ const basePath = pathname.slice(0, pathname.length - relativePath.length);
60
+ return basePath === '' || (basePath.startsWith('/') && !basePath.endsWith('/'));
61
+ }
62
+ function diffClientSets(deploymentIds, manifestIds) {
63
+ const deploymentSet = new Set(deploymentIds);
64
+ const manifestSet = new Set(manifestIds);
65
+ const deploymentOnly = [...deploymentSet].filter((id) => !manifestSet.has(id)).sort();
66
+ const manifestOnly = [...manifestSet].filter((id) => !deploymentSet.has(id)).sort();
67
+ return {
68
+ equal: deploymentOnly.length === 0 && manifestOnly.length === 0,
69
+ deploymentOnly,
70
+ manifestOnly,
71
+ };
72
+ }
73
+ /**
74
+ * Computes the single authoritative set of enabled MCP resources at startup (`1A` §8,
75
+ * `mcp-connector-contract.md` §1, §7.3). RPC, PRM, and discovery push all consult this set
76
+ * instead of reading `deployment.mcp[kind].enabled` directly.
77
+ */
78
+ let McpEnabledResources = McpEnabledResources_1 = class McpEnabledResources {
79
+ constructor(deployment, options, iamProfile) {
80
+ this.logger = new common_1.Logger(McpEnabledResources_1.name);
81
+ this.byKind = new Map();
82
+ this.warnedDynamicCommands = new Set();
83
+ this.compute(deployment, options, iamProfile, false);
84
+ }
85
+ /** Creates a silent empty instance for fallback when a controller is instantiated without DI. */
86
+ static empty() {
87
+ const instance = Object.create(McpEnabledResources_1.prototype);
88
+ instance.logger = new common_1.Logger(McpEnabledResources_1.name);
89
+ instance.byKind =
90
+ new Map();
91
+ instance.warnedDynamicCommands =
92
+ new Set();
93
+ return instance;
94
+ }
95
+ isEnabled(kind) {
96
+ return this.byKind.has(kind);
97
+ }
98
+ get(kind) {
99
+ return this.byKind.get(kind);
100
+ }
101
+ getEnabledResources() {
102
+ const result = [];
103
+ for (const kind of RESOURCE_KINDS) {
104
+ const resource = this.byKind.get(kind);
105
+ if (resource) {
106
+ result.push(resource);
107
+ }
108
+ }
109
+ return result;
110
+ }
111
+ getEnabledKinds() {
112
+ return this.getEnabledResources().map((r) => r.kind);
113
+ }
114
+ isCommandScopeAllowed(kind, scope) {
115
+ const resource = this.byKind.get(kind);
116
+ if (!resource)
117
+ return false;
118
+ return resource.scopeSet.has(scope);
119
+ }
120
+ warnDynamicCommandScopeOnce(kind, commandName) {
121
+ if (this.warnedDynamicCommands.has(commandName)) {
122
+ return;
123
+ }
124
+ this.warnedDynamicCommands.add(commandName);
125
+ this.logger.warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_DYNAMIC_COMMAND_SCOPE_UNDECLARED}] resource=${kind}: dynamic command "${commandName}" declares a scope outside manifest scopes and is unavailable.`);
126
+ }
127
+ compute(deployment, options, iamProfile, silent) {
128
+ const warn = (message) => {
129
+ if (!silent) {
130
+ this.logger.warn(message);
131
+ }
132
+ };
133
+ if (!deployment) {
134
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.DEPLOYMENT_CONFIG_MISSING}] resources=employee,admin: MCP deployment configuration is missing; all MCP resources are disabled.`);
135
+ return;
136
+ }
137
+ if (!options) {
138
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.CONNECTOR_MANIFEST_MISSING}] resources=employee,admin: McpModule.forRoot was called without options (connectorManifest); all MCP resources are disabled.`);
139
+ return;
140
+ }
141
+ let sharedValid = true;
142
+ const manifestDiagnostics = (0, plugin_api_1.validateConnectorManifest)(options.connectorManifest);
143
+ if ((0, plugin_api_1.hasErrors)(manifestDiagnostics)) {
144
+ const diagnosticCodes = manifestDiagnostics
145
+ .filter((d) => d.severity === 'error')
146
+ .map((d) => d.code)
147
+ .join(',');
148
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_INVALID}] resources=employee,admin: Connector manifest validation failed (diagnostics=${diagnosticCodes}); all MCP resources are disabled.`);
149
+ sharedValid = false;
150
+ }
151
+ const hasProfile = iamProfile !== undefined && iamProfile !== null && typeof iamProfile === 'object';
152
+ if (!hasProfile) {
153
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.IAM_PROFILE_MISSING}] resources=employee,admin: IAM_PROFILE provider is missing; all MCP resources are disabled.`);
154
+ sharedValid = false;
155
+ }
156
+ else if (iamProfile.issuer !== deployment.issuer) {
157
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.IAM_ISSUER_MISMATCH}] resources=employee,admin: IAM_PROFILE.issuer does not match deployment.issuer; all MCP resources are disabled.`);
158
+ sharedValid = false;
159
+ }
160
+ if (!sharedValid || !hasProfile) {
161
+ return;
162
+ }
163
+ const manifest = options.connectorManifest;
164
+ for (const kind of RESOURCE_KINDS) {
165
+ const manifestResource = kind === 'employee' ? manifest.employee : manifest.admin;
166
+ const deploymentResource = deployment.mcp[kind];
167
+ const manifestEnabled = manifestResource?.enabled === true;
168
+ const deploymentEnabled = deploymentResource.enabled === true;
169
+ if (!manifestEnabled && !deploymentEnabled) {
170
+ continue;
171
+ }
172
+ if (manifestEnabled !== deploymentEnabled) {
173
+ const disabledBy = manifestEnabled ? 'deployment' : 'manifest';
174
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_ENABLED_MISMATCH}] resource=${kind}: Resource is disabled in ${disabledBy} (disabledBy=${disabledBy}); resource is disabled.`);
175
+ continue;
176
+ }
177
+ if (!manifestResource) {
178
+ continue;
179
+ }
180
+ let resourceValid = true;
181
+ if (!matchesRelativePath(deploymentResource.canonicalResourceUrl, manifestResource.relativePath)) {
182
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_PATH_MISMATCH}] resource=${kind}: deployment canonicalResourceUrl pathname does not match manifest relativePath boundary.`);
183
+ resourceValid = false;
184
+ }
185
+ const clientDiff = diffClientSets(deploymentResource.allowedClientIds, manifestResource.allowedClientIds);
186
+ if (!clientDiff.equal) {
187
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_CLIENT_MISMATCH}] resource=${kind}: allowedClientIds mismatch (deploymentOnly=[${clientDiff.deploymentOnly.join(',')}], manifestOnly=[${clientDiff.manifestOnly.join(',')}]).`);
188
+ resourceValid = false;
189
+ }
190
+ const manifestScopeSet = new Set(manifestResource.scopes.map((entry) => entry.scope));
191
+ const surface = kind === 'admin' ? 'mcp-admin' : 'mcp';
192
+ const staticCommands = options.commands && typeof options.commands.list === 'function'
193
+ ? options.commands.list(surface)
194
+ : [];
195
+ const undeclaredCommandNames = staticCommands
196
+ .filter((cmd) => !manifestScopeSet.has(cmd.scope))
197
+ .map((cmd) => cmd.name);
198
+ if (undeclaredCommandNames.length > 0) {
199
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_COMMAND_SCOPE_UNDECLARED}] resource=${kind}: static command(s) [${undeclaredCommandNames.join(', ')}] declare scopes outside manifest scopes.`);
200
+ resourceValid = false;
201
+ }
202
+ if (kind === 'admin') {
203
+ if (deployment.mcp.admin.maxAuthAgeSeconds !== manifestResource.adminMaxAuthAgeSeconds) {
204
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_ADMIN_MAX_AUTH_AGE_MISMATCH}] resource=admin: deployment maxAuthAgeSeconds does not match manifest adminMaxAuthAgeSeconds.`);
205
+ resourceValid = false;
206
+ }
207
+ if (iamProfile.mcpCapabilities?.adminMfa !== true) {
208
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.IAM_ADMIN_MFA_UNSUPPORTED}] resource=admin: IAM_PROFILE.mcpCapabilities.adminMfa is not true.`);
209
+ resourceValid = false;
210
+ }
211
+ const requiredScope = deployment.mcp.admin.requiredScope;
212
+ if (!requiredScope || !manifestScopeSet.has(requiredScope)) {
213
+ warn(`[${exports.MCP_VALIDATION_WARNING_CODES.MANIFEST_ADMIN_REQUIRED_SCOPE_UNDECLARED}] resource=admin: deployment admin requiredScope is not present in manifest admin scopes.`);
214
+ resourceValid = false;
215
+ }
216
+ }
217
+ if (resourceValid) {
218
+ this.byKind.set(kind, {
219
+ kind,
220
+ issuer: deployment.issuer,
221
+ canonicalResourceUrl: deploymentResource.canonicalResourceUrl,
222
+ relativePath: manifestResource.relativePath,
223
+ allowedClientIds: [...manifestResource.allowedClientIds],
224
+ scopes: [...manifestScopeSet],
225
+ scopeSet: manifestScopeSet,
226
+ });
227
+ }
228
+ }
229
+ }
230
+ };
231
+ exports.McpEnabledResources = McpEnabledResources;
232
+ exports.McpEnabledResources = McpEnabledResources = McpEnabledResources_1 = __decorate([
233
+ (0, common_1.Injectable)(),
234
+ __param(0, (0, common_1.Optional)()),
235
+ __param(0, (0, common_1.Inject)(deployment_config_1.MCP_DEPLOYMENT_CONFIG)),
236
+ __param(1, (0, common_1.Optional)()),
237
+ __param(1, (0, common_1.Inject)(types_1.MCP_COMMANDS_OPTIONS)),
238
+ __param(2, (0, common_1.Optional)()),
239
+ __param(2, (0, common_1.Inject)(plugin_api_1.IAM_PROFILE)),
240
+ __metadata("design:paramtypes", [Object, Object, Object])
241
+ ], McpEnabledResources);
242
+ exports.EMPTY_ENABLED_RESOURCES = McpEnabledResources.empty();
243
+ //# sourceMappingURL=enabled-resources.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enabled-resources.js","sourceRoot":"","sources":["../src/enabled-resources.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import { type IamProfilePort, type IdentityStorePort, type OidcIdentityLookupPort, type RbacPolicyPort } from '@haneinfo/plugin-api';
2
+ import type { Request } from 'express';
3
+ import { type McpAuthResult, type McpRequestAuthenticator } from './authenticator';
4
+ import { type McpIamDeploymentConfig } from './deployment-config';
5
+ import type { McpResourceKind } from './types';
6
+ export declare const MCP_SIGNING_KEY_RESOLVER: unique symbol;
7
+ export type McpSigningKeyResolver = (kid: string, jwksUri: string) => Promise<string>;
8
+ /**
9
+ * OAuth access token authenticator for `/mcp` and `/mcp/admin` (1A §2, §3).
10
+ *
11
+ * Verifies JWT signature, claims, timestamps, deployment allowlists, local `(issuer, subject)`
12
+ * mapping (read-only, never provisioning), and per-request local account admission.
13
+ */
14
+ export declare class IamMcpRequestAuthenticator implements McpRequestAuthenticator {
15
+ private readonly deployment;
16
+ private readonly iamProfile;
17
+ private readonly oidcIdentityLookup;
18
+ private readonly identityStore;
19
+ private readonly rbacPolicy;
20
+ private readonly signingKeyResolver?;
21
+ private readonly logger;
22
+ private jwksClients;
23
+ constructor(deployment: McpIamDeploymentConfig, iamProfile: IamProfilePort, oidcIdentityLookup: OidcIdentityLookupPort, identityStore: IdentityStorePort, rbacPolicy: Pick<RbacPolicyPort, 'rolesForUser'>, signingKeyResolver?: McpSigningKeyResolver | undefined);
24
+ authenticate(request: Request, kind: McpResourceKind): Promise<McpAuthResult>;
25
+ private getJwksClient;
26
+ private resolveSigningKey;
27
+ private verifySignature;
28
+ }
29
+ //# sourceMappingURL=iam-authenticator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"iam-authenticator.d.ts","sourceRoot":"","sources":["../src/iam-authenticator.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EAItB,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/D,eAAO,MAAM,wBAAwB,eAAyD,CAAC;AAE/F,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AA8BtF;;;;;GAKG;AACH,qBACa,0BAA2B,YAAW,uBAAuB;IAKvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAGhD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAXtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,WAAW,CAAiC;gBAGF,UAAU,EAAE,sBAAsB,EAC5C,UAAU,EAAE,cAAc,EACjB,kBAAkB,EAAE,sBAAsB,EAChD,aAAa,EAAE,iBAAiB,EACnC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,EAGrE,kBAAkB,CAAC,EAAE,qBAAqB,YAAA;IAGvD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IA0KnF,OAAO,CAAC,aAAa;YAcP,iBAAiB;IAQ/B,OAAO,CAAC,eAAe;CAwBxB"}