@mcp-audit-gateway/core 0.1.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 (145) hide show
  1. package/.github/workflows/npm-publish.yml +21 -0
  2. package/CONTRIBUTING.md +41 -0
  3. package/LICENSE +21 -0
  4. package/README.md +156 -0
  5. package/dist/attestation/audit-log.d.ts +25 -0
  6. package/dist/attestation/audit-log.d.ts.map +1 -0
  7. package/dist/attestation/audit-log.js +95 -0
  8. package/dist/attestation/audit-log.js.map +1 -0
  9. package/dist/attestation/bugfix.test.d.ts +2 -0
  10. package/dist/attestation/bugfix.test.d.ts.map +1 -0
  11. package/dist/attestation/bugfix.test.js +103 -0
  12. package/dist/attestation/bugfix.test.js.map +1 -0
  13. package/dist/attestation/chain.test.d.ts +2 -0
  14. package/dist/attestation/chain.test.d.ts.map +1 -0
  15. package/dist/attestation/chain.test.js +153 -0
  16. package/dist/attestation/chain.test.js.map +1 -0
  17. package/dist/attestation/keygen.d.ts +5 -0
  18. package/dist/attestation/keygen.d.ts.map +1 -0
  19. package/dist/attestation/keygen.js +12 -0
  20. package/dist/attestation/keygen.js.map +1 -0
  21. package/dist/attestation/signer.d.ts +25 -0
  22. package/dist/attestation/signer.d.ts.map +1 -0
  23. package/dist/attestation/signer.js +93 -0
  24. package/dist/attestation/signer.js.map +1 -0
  25. package/dist/attestation/signer.test.d.ts +2 -0
  26. package/dist/attestation/signer.test.d.ts.map +1 -0
  27. package/dist/attestation/signer.test.js +62 -0
  28. package/dist/attestation/signer.test.js.map +1 -0
  29. package/dist/attestation/verify.d.ts +26 -0
  30. package/dist/attestation/verify.d.ts.map +1 -0
  31. package/dist/attestation/verify.js +104 -0
  32. package/dist/attestation/verify.js.map +1 -0
  33. package/dist/attestation/verify.test.d.ts +2 -0
  34. package/dist/attestation/verify.test.d.ts.map +1 -0
  35. package/dist/attestation/verify.test.js +79 -0
  36. package/dist/attestation/verify.test.js.map +1 -0
  37. package/dist/cli.d.ts +3 -0
  38. package/dist/cli.d.ts.map +1 -0
  39. package/dist/cli.js +364 -0
  40. package/dist/cli.js.map +1 -0
  41. package/dist/index.d.ts +12 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +12 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/integration.test.d.ts +2 -0
  46. package/dist/integration.test.d.ts.map +1 -0
  47. package/dist/integration.test.js +88 -0
  48. package/dist/integration.test.js.map +1 -0
  49. package/dist/policy/engine.d.ts +24 -0
  50. package/dist/policy/engine.d.ts.map +1 -0
  51. package/dist/policy/engine.js +130 -0
  52. package/dist/policy/engine.js.map +1 -0
  53. package/dist/policy/engine.test.d.ts +2 -0
  54. package/dist/policy/engine.test.d.ts.map +1 -0
  55. package/dist/policy/engine.test.js +80 -0
  56. package/dist/policy/engine.test.js.map +1 -0
  57. package/dist/proxy/gateway.d.ts +54 -0
  58. package/dist/proxy/gateway.d.ts.map +1 -0
  59. package/dist/proxy/gateway.js +245 -0
  60. package/dist/proxy/gateway.js.map +1 -0
  61. package/dist/proxy/gateway.test.d.ts +2 -0
  62. package/dist/proxy/gateway.test.d.ts.map +1 -0
  63. package/dist/proxy/gateway.test.js +93 -0
  64. package/dist/proxy/gateway.test.js.map +1 -0
  65. package/dist/proxy/mcp-server-adapter.d.ts +21 -0
  66. package/dist/proxy/mcp-server-adapter.d.ts.map +1 -0
  67. package/dist/proxy/mcp-server-adapter.js +98 -0
  68. package/dist/proxy/mcp-server-adapter.js.map +1 -0
  69. package/dist/proxy/mcp-server-adapter.test.d.ts +2 -0
  70. package/dist/proxy/mcp-server-adapter.test.d.ts.map +1 -0
  71. package/dist/proxy/mcp-server-adapter.test.js +160 -0
  72. package/dist/proxy/mcp-server-adapter.test.js.map +1 -0
  73. package/dist/proxy/upstream-manager.d.ts +49 -0
  74. package/dist/proxy/upstream-manager.d.ts.map +1 -0
  75. package/dist/proxy/upstream-manager.js +246 -0
  76. package/dist/proxy/upstream-manager.js.map +1 -0
  77. package/dist/proxy/upstream-manager.test.d.ts +2 -0
  78. package/dist/proxy/upstream-manager.test.d.ts.map +1 -0
  79. package/dist/proxy/upstream-manager.test.js +413 -0
  80. package/dist/proxy/upstream-manager.test.js.map +1 -0
  81. package/dist/telemetry/logger.d.ts +26 -0
  82. package/dist/telemetry/logger.d.ts.map +1 -0
  83. package/dist/telemetry/logger.js +48 -0
  84. package/dist/telemetry/logger.js.map +1 -0
  85. package/dist/telemetry/logger.test.d.ts +2 -0
  86. package/dist/telemetry/logger.test.d.ts.map +1 -0
  87. package/dist/telemetry/logger.test.js +124 -0
  88. package/dist/telemetry/logger.test.js.map +1 -0
  89. package/dist/telemetry/metrics.d.ts +41 -0
  90. package/dist/telemetry/metrics.d.ts.map +1 -0
  91. package/dist/telemetry/metrics.js +64 -0
  92. package/dist/telemetry/metrics.js.map +1 -0
  93. package/dist/telemetry/metrics.test.d.ts +2 -0
  94. package/dist/telemetry/metrics.test.d.ts.map +1 -0
  95. package/dist/telemetry/metrics.test.js +93 -0
  96. package/dist/telemetry/metrics.test.js.map +1 -0
  97. package/dist/telemetry/tracer.d.ts +16 -0
  98. package/dist/telemetry/tracer.d.ts.map +1 -0
  99. package/dist/telemetry/tracer.js +71 -0
  100. package/dist/telemetry/tracer.js.map +1 -0
  101. package/dist/types.d.ts +477 -0
  102. package/dist/types.d.ts.map +1 -0
  103. package/dist/types.js +68 -0
  104. package/dist/types.js.map +1 -0
  105. package/dist/wrap/proxy.d.ts +2 -0
  106. package/dist/wrap/proxy.d.ts.map +1 -0
  107. package/dist/wrap/proxy.js +152 -0
  108. package/dist/wrap/proxy.js.map +1 -0
  109. package/dist/wrap/proxy.test.d.ts +2 -0
  110. package/dist/wrap/proxy.test.d.ts.map +1 -0
  111. package/dist/wrap/proxy.test.js +155 -0
  112. package/dist/wrap/proxy.test.js.map +1 -0
  113. package/examples/README.md +33 -0
  114. package/examples/claude-desktop.json +50 -0
  115. package/examples/multi-agent-production.json +72 -0
  116. package/gateway.config.example.json +61 -0
  117. package/package.json +49 -0
  118. package/src/attestation/audit-log.ts +126 -0
  119. package/src/attestation/bugfix.test.ts +113 -0
  120. package/src/attestation/chain.test.ts +188 -0
  121. package/src/attestation/keygen.ts +18 -0
  122. package/src/attestation/signer.test.ts +75 -0
  123. package/src/attestation/signer.ts +105 -0
  124. package/src/attestation/verify.test.ts +86 -0
  125. package/src/attestation/verify.ts +131 -0
  126. package/src/cli.ts +407 -0
  127. package/src/index.ts +21 -0
  128. package/src/integration.test.ts +108 -0
  129. package/src/policy/engine.test.ts +95 -0
  130. package/src/policy/engine.ts +162 -0
  131. package/src/proxy/gateway.test.ts +108 -0
  132. package/src/proxy/gateway.ts +328 -0
  133. package/src/proxy/mcp-server-adapter.test.ts +197 -0
  134. package/src/proxy/mcp-server-adapter.ts +140 -0
  135. package/src/proxy/upstream-manager.test.ts +534 -0
  136. package/src/proxy/upstream-manager.ts +326 -0
  137. package/src/telemetry/logger.test.ts +139 -0
  138. package/src/telemetry/logger.ts +72 -0
  139. package/src/telemetry/metrics.test.ts +125 -0
  140. package/src/telemetry/metrics.ts +83 -0
  141. package/src/telemetry/tracer.ts +90 -0
  142. package/src/types.ts +113 -0
  143. package/src/wrap/proxy.test.ts +175 -0
  144. package/src/wrap/proxy.ts +192 -0
  145. package/tsconfig.json +18 -0
@@ -0,0 +1,130 @@
1
+ export class PolicyEngine {
2
+ defaultEffect;
3
+ rules;
4
+ rateLimitState = {
5
+ minuteCounts: new Map(),
6
+ hourCounts: new Map(),
7
+ };
8
+ constructor(defaultEffect, rules) {
9
+ this.defaultEffect = defaultEffect;
10
+ this.rules = rules;
11
+ }
12
+ evaluate(principal, tool) {
13
+ let matchedRule = null;
14
+ for (const rule of this.rules) {
15
+ if (this.ruleMatches(rule, principal, tool)) {
16
+ matchedRule = rule;
17
+ break;
18
+ }
19
+ }
20
+ if (!matchedRule) {
21
+ return { allowed: this.defaultEffect === "allow" };
22
+ }
23
+ if (matchedRule.effect === "deny") {
24
+ return { allowed: false, reason: "denied by policy rule" };
25
+ }
26
+ if (matchedRule.rateLimit) {
27
+ const key = `${principal ?? "anonymous"}:${tool.name}`;
28
+ const rateLimited = this.checkRateLimit(key, matchedRule.rateLimit);
29
+ if (rateLimited) {
30
+ return { allowed: false, reason: "rate limit exceeded", rateLimit: matchedRule.rateLimit };
31
+ }
32
+ }
33
+ return { allowed: true, rateLimit: matchedRule.rateLimit };
34
+ }
35
+ filterTools(principal, tools) {
36
+ return tools.filter((tool) => this.evaluate(principal, tool).allowed);
37
+ }
38
+ recordInvocation(principal, tool) {
39
+ const key = `${principal ?? "anonymous"}:${tool.name}`;
40
+ this.incrementCounter(key);
41
+ }
42
+ ruleMatches(rule, principal, tool) {
43
+ if (rule.principals && rule.principals.length > 0) {
44
+ if (!principal || !this.matchesPattern(principal, rule.principals)) {
45
+ return false;
46
+ }
47
+ }
48
+ if (rule.namespaces && rule.namespaces.length > 0) {
49
+ if (!rule.namespaces.includes(tool.namespace)) {
50
+ return false;
51
+ }
52
+ }
53
+ if (rule.tools && rule.tools.length > 0) {
54
+ if (!this.matchesPattern(tool.name, rule.tools) &&
55
+ !this.matchesPattern(tool.originalName, rule.tools)) {
56
+ return false;
57
+ }
58
+ }
59
+ return true;
60
+ }
61
+ matchesPattern(value, patterns) {
62
+ return patterns.some((pattern) => this.globMatch(pattern, value));
63
+ }
64
+ globMatch(pattern, value) {
65
+ if (!pattern.includes("*"))
66
+ return pattern === value;
67
+ const parts = pattern.split("*");
68
+ let pos = 0;
69
+ for (let i = 0; i < parts.length; i++) {
70
+ const part = parts[i];
71
+ if (part === "")
72
+ continue;
73
+ if (i === 0) {
74
+ if (!value.startsWith(part))
75
+ return false;
76
+ pos = part.length;
77
+ }
78
+ else if (i === parts.length - 1) {
79
+ if (value.length - pos < part.length)
80
+ return false;
81
+ if (!value.endsWith(part))
82
+ return false;
83
+ const suffixStart = value.length - part.length;
84
+ if (suffixStart < pos)
85
+ return false;
86
+ }
87
+ else {
88
+ const idx = value.indexOf(part, pos);
89
+ if (idx === -1)
90
+ return false;
91
+ pos = idx + part.length;
92
+ }
93
+ }
94
+ return true;
95
+ }
96
+ checkRateLimit(key, limit) {
97
+ const now = Date.now();
98
+ if (limit.maxPerMinute != null) {
99
+ const entry = this.rateLimitState.minuteCounts.get(key);
100
+ if (entry && entry.resetAt > now && entry.count >= limit.maxPerMinute) {
101
+ return true;
102
+ }
103
+ }
104
+ if (limit.maxPerHour != null) {
105
+ const entry = this.rateLimitState.hourCounts.get(key);
106
+ if (entry && entry.resetAt > now && entry.count >= limit.maxPerHour) {
107
+ return true;
108
+ }
109
+ }
110
+ return false;
111
+ }
112
+ incrementCounter(key) {
113
+ const now = Date.now();
114
+ const minute = this.rateLimitState.minuteCounts.get(key);
115
+ if (!minute || minute.resetAt <= now) {
116
+ this.rateLimitState.minuteCounts.set(key, { count: 1, resetAt: now + 60_000 });
117
+ }
118
+ else {
119
+ minute.count++;
120
+ }
121
+ const hour = this.rateLimitState.hourCounts.get(key);
122
+ if (!hour || hour.resetAt <= now) {
123
+ this.rateLimitState.hourCounts.set(key, { count: 1, resetAt: now + 3_600_000 });
124
+ }
125
+ else {
126
+ hour.count++;
127
+ }
128
+ }
129
+ }
130
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/policy/engine.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,YAAY;IAOb;IACA;IAPF,cAAc,GAAmB;QACvC,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,UAAU,EAAE,IAAI,GAAG,EAAE;KACtB,CAAC;IAEF,YACU,aAA+B,EAC/B,KAAmB;QADnB,kBAAa,GAAb,aAAa,CAAkB;QAC/B,UAAK,GAAL,KAAK,CAAc;IAC1B,CAAC;IAEJ,QAAQ,CAAC,SAA6B,EAAE,IAAe;QACrD,IAAI,WAAW,GAAsB,IAAI,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC5C,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;QACrD,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;QAC7D,CAAC;QAED,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;YACpE,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC;YAC7F,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;IAED,WAAW,CAAC,SAA6B,EAAE,KAAkB;QAC3D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,gBAAgB,CAAC,SAA6B,EAAE,IAAe;QAC7D,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAEO,WAAW,CACjB,IAAgB,EAChB,SAA6B,EAC7B,IAAe;QAEf,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9C,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;gBAC3C,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CAAC,KAAa,EAAE,QAAkB;QACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,KAAa;QAC9C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,KAAK,KAAK,CAAC;QAErD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,EAAE;gBAAE,SAAS;YAE1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC1C,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;YACpB,CAAC;iBAAM,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM;oBAAE,OAAO,KAAK,CAAC;gBACnD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACxC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC/C,IAAI,WAAW,GAAG,GAAG;oBAAE,OAAO,KAAK,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACrC,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC7B,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CACpB,GAAW,EACX,KAAqD;QAErD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxD,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACtE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACpE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,GAAW;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,SAAS,EAAE,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=engine.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.test.d.ts","sourceRoot":"","sources":["../../src/policy/engine.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,80 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import { PolicyEngine } from "./engine.js";
3
+ const tool = (name, ns) => ({
4
+ name: `${ns}/${name}`,
5
+ originalName: name,
6
+ namespace: ns,
7
+ upstream: `${ns}-server`,
8
+ });
9
+ describe("PolicyEngine", () => {
10
+ describe("default-allow", () => {
11
+ const engine = new PolicyEngine("allow", [
12
+ { effect: "deny", principals: ["agent:readonly-*"], tools: ["*/write_*", "*/delete_*"] },
13
+ { effect: "deny", tools: ["admin/shutdown"] },
14
+ ]);
15
+ it("allows unmatched tools", () => {
16
+ const decision = engine.evaluate("agent:dev", tool("read_data", "github"));
17
+ expect(decision.allowed).toBe(true);
18
+ });
19
+ it("denies matching principal+tool pattern", () => {
20
+ const decision = engine.evaluate("agent:readonly-bot", tool("write_file", "fs"));
21
+ expect(decision.allowed).toBe(false);
22
+ });
23
+ it("allows write for non-readonly principal", () => {
24
+ const decision = engine.evaluate("agent:admin", tool("write_file", "fs"));
25
+ expect(decision.allowed).toBe(true);
26
+ });
27
+ it("denies tool pattern regardless of principal", () => {
28
+ const decision = engine.evaluate("agent:admin", tool("shutdown", "admin"));
29
+ expect(decision.allowed).toBe(false);
30
+ });
31
+ });
32
+ describe("default-deny", () => {
33
+ const engine = new PolicyEngine("deny", [
34
+ { effect: "allow", principals: ["agent:trusted-*"], namespaces: ["github"] },
35
+ ]);
36
+ it("denies by default", () => {
37
+ const decision = engine.evaluate("agent:unknown", tool("create_pr", "github"));
38
+ expect(decision.allowed).toBe(false);
39
+ });
40
+ it("allows matching principal+namespace", () => {
41
+ const decision = engine.evaluate("agent:trusted-ci", tool("create_pr", "github"));
42
+ expect(decision.allowed).toBe(true);
43
+ });
44
+ it("denies trusted principal on wrong namespace", () => {
45
+ const decision = engine.evaluate("agent:trusted-ci", tool("drop_table", "database"));
46
+ expect(decision.allowed).toBe(false);
47
+ });
48
+ });
49
+ describe("rate limiting", () => {
50
+ it("allows calls within limit", () => {
51
+ const engine = new PolicyEngine("allow", [
52
+ { effect: "allow", principals: ["agent:bot"], rateLimit: { maxPerMinute: 3 } },
53
+ ]);
54
+ const t = tool("read", "api");
55
+ engine.evaluate("agent:bot", t);
56
+ engine.recordInvocation("agent:bot", t);
57
+ engine.recordInvocation("agent:bot", t);
58
+ engine.recordInvocation("agent:bot", t);
59
+ const decision = engine.evaluate("agent:bot", t);
60
+ expect(decision.allowed).toBe(false);
61
+ expect(decision.reason).toContain("rate limit");
62
+ });
63
+ });
64
+ describe("filterTools", () => {
65
+ const engine = new PolicyEngine("allow", [
66
+ { effect: "deny", principals: ["agent:limited"], tools: ["*/dangerous_*"] },
67
+ ]);
68
+ it("removes denied tools from list", () => {
69
+ const tools = [
70
+ tool("safe_read", "fs"),
71
+ tool("dangerous_delete", "fs"),
72
+ tool("safe_write", "fs"),
73
+ ];
74
+ const filtered = engine.filterTools("agent:limited", tools);
75
+ expect(filtered).toHaveLength(2);
76
+ expect(filtered.map((t) => t.originalName)).not.toContain("dangerous_delete");
77
+ });
78
+ });
79
+ });
80
+ //# sourceMappingURL=engine.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.test.js","sourceRoot":"","sources":["../../src/policy/engine.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,54 @@
1
+ import type { GatewayConfig, UpstreamStatus, AuditRecord } from "../types.js";
2
+ export declare class Gateway {
3
+ private config;
4
+ private toolCatalog;
5
+ private manualStatuses?;
6
+ private policyEngine;
7
+ private auditLog;
8
+ private tracer;
9
+ private metrics;
10
+ private upstreamManager;
11
+ constructor(config: GatewayConfig);
12
+ init(): Promise<void>;
13
+ private connectUpstream;
14
+ handleToolsList(principal?: string, _meta?: Record<string, unknown>): Promise<{
15
+ tools: unknown[];
16
+ _meta?: Record<string, unknown>;
17
+ }>;
18
+ handleToolsCall(toolName: string, args: Record<string, unknown>, principal?: string, traceContext?: {
19
+ traceparent?: string;
20
+ tracestate?: string;
21
+ }): Promise<{
22
+ result: unknown;
23
+ auditRecord: AuditRecord;
24
+ }>;
25
+ getStatus(): {
26
+ gateway: {
27
+ status: string;
28
+ version: string;
29
+ };
30
+ upstreams: UpstreamStatus[];
31
+ aggregate: {
32
+ totalUpstreams: number;
33
+ healthyUpstreams: number;
34
+ degradedUpstreams: number;
35
+ unavailableUpstreams: number;
36
+ totalTools: number;
37
+ };
38
+ };
39
+ getServerDiscover(): Record<string, unknown>;
40
+ registerUpstreamTools(upstreamName: string, namespace: string, tools: Array<{
41
+ name: string;
42
+ description?: string;
43
+ inputSchema?: unknown;
44
+ annotations?: Record<string, unknown>;
45
+ }>): void;
46
+ private safeAuditRecord;
47
+ shutdown(): Promise<void>;
48
+ }
49
+ export declare class ToolCallError extends Error {
50
+ code: number;
51
+ auditRecord: AuditRecord;
52
+ constructor(code: number, message: string, auditRecord: AuditRecord);
53
+ }
54
+ //# sourceMappingURL=gateway.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/proxy/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,cAAc,EAEd,WAAW,EACZ,MAAM,aAAa,CAAC;AAQrB,qBAAa,OAAO;IASN,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,cAAc,CAAC,CAA8B;IACrD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,eAAe,CAAkB;gBAErB,MAAM,EAAE,aAAa;IAkBnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,eAAe;IAavB,eAAe,CACnB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IA8B3D,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,CAAC;IA8GzD,SAAS,IAAI;QACX,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,SAAS,EAAE,cAAc,EAAE,CAAC;QAC5B,SAAS,EAAE;YACT,cAAc,EAAE,MAAM,CAAC;YACvB,gBAAgB,EAAE,MAAM,CAAC;YACzB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,oBAAoB,EAAE,MAAM,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH;IAoBD,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoB5C,qBAAqB,CACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC,GACD,IAAI;YA2BO,eAAe;IAkBvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC;AAED,qBAAa,aAAc,SAAQ,KAAK;IAE7B,IAAI,EAAE,MAAM;IAEZ,WAAW,EAAE,WAAW;gBAFxB,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,WAAW,EAAE,WAAW;CAKlC"}
@@ -0,0 +1,245 @@
1
+ import { PolicyEngine } from "../policy/engine.js";
2
+ import { AuditLog } from "../attestation/audit-log.js";
3
+ import { createSigner } from "../attestation/signer.js";
4
+ import { GatewayTracer } from "../telemetry/tracer.js";
5
+ import { GatewayMetrics } from "../telemetry/metrics.js";
6
+ import { UpstreamManager } from "./upstream-manager.js";
7
+ export class Gateway {
8
+ config;
9
+ toolCatalog = new Map();
10
+ manualStatuses;
11
+ policyEngine;
12
+ auditLog;
13
+ tracer;
14
+ metrics;
15
+ upstreamManager;
16
+ constructor(config) {
17
+ this.config = config;
18
+ this.policyEngine = new PolicyEngine(config.policy.defaultEffect, config.policy.rules);
19
+ const signer = createSigner(config.attestation);
20
+ this.auditLog = new AuditLog(config.auditLog.path, signer, config.auditLog.rotateAfterMb * 1024 * 1024);
21
+ this.tracer = new GatewayTracer(config.telemetry);
22
+ this.metrics = new GatewayMetrics(config.telemetry);
23
+ this.upstreamManager = new UpstreamManager();
24
+ }
25
+ async init() {
26
+ await this.auditLog.init();
27
+ for (const upstream of this.config.upstreams) {
28
+ await this.connectUpstream(upstream);
29
+ }
30
+ }
31
+ async connectUpstream(upstream) {
32
+ try {
33
+ const conn = await this.upstreamManager.connect(upstream);
34
+ this.registerUpstreamTools(upstream.name, upstream.namespace, conn.tools);
35
+ }
36
+ catch (err) {
37
+ console.error(`Failed to connect to upstream ${upstream.name}: ${err}`);
38
+ }
39
+ }
40
+ async handleToolsList(principal, _meta) {
41
+ const allTools = Array.from(this.toolCatalog.values());
42
+ const filtered = this.policyEngine.filterTools(principal, allTools);
43
+ const tools = filtered.map((entry) => ({
44
+ name: entry.name,
45
+ description: entry.description,
46
+ inputSchema: entry.inputSchema,
47
+ annotations: entry.annotations,
48
+ _meta: {
49
+ "x-gateway-routing/v1": {
50
+ upstream: entry.upstream,
51
+ namespace: entry.namespace,
52
+ },
53
+ },
54
+ }));
55
+ return {
56
+ tools,
57
+ _meta: {
58
+ "x-gateway-routing/v1": {
59
+ filteringApplied: true,
60
+ identityResolved: principal ?? "anonymous",
61
+ totalToolsPreFilter: this.toolCatalog.size,
62
+ totalToolsPostFilter: filtered.length,
63
+ },
64
+ },
65
+ };
66
+ }
67
+ async handleToolsCall(toolName, args, principal, traceContext) {
68
+ const startTime = Date.now();
69
+ const tool = this.toolCatalog.get(toolName);
70
+ if (!tool) {
71
+ const record = await this.auditLog.record("tools/call", {
72
+ toolName,
73
+ principal,
74
+ durationMs: Date.now() - startTime,
75
+ success: false,
76
+ errorCode: -32602,
77
+ });
78
+ throw new ToolCallError(-32602, `Unknown tool: ${toolName}`, record);
79
+ }
80
+ const decision = this.policyEngine.evaluate(principal, tool);
81
+ if (!decision.allowed) {
82
+ this.metrics.recordPolicyDenial({
83
+ principal: principal ?? "anonymous",
84
+ tool: toolName,
85
+ reason: decision.reason ?? "unauthorized",
86
+ });
87
+ const record = await this.auditLog.record("tools/call", {
88
+ toolName,
89
+ namespace: tool.namespace,
90
+ upstream: tool.upstream,
91
+ principal,
92
+ durationMs: Date.now() - startTime,
93
+ success: false,
94
+ errorCode: -32603,
95
+ });
96
+ throw new ToolCallError(-32603, decision.reason ?? "unauthorized", record);
97
+ }
98
+ const span = this.tracer.startRouteSpan("tools/call", toolName, tool.upstream, traceContext);
99
+ try {
100
+ this.policyEngine.recordInvocation(principal, tool);
101
+ const result = await this.upstreamManager.callTool(tool.upstream, tool.originalName, args);
102
+ const durationMs = Date.now() - startTime;
103
+ this.tracer.recordDuration(span, durationMs);
104
+ this.tracer.endSpan(span, true);
105
+ this.metrics.recordToolCall({
106
+ namespace: tool.namespace,
107
+ tool: toolName,
108
+ principal: principal ?? "anonymous",
109
+ success: "true",
110
+ });
111
+ this.metrics.recordDuration(durationMs, {
112
+ namespace: tool.namespace,
113
+ upstream: tool.upstream,
114
+ });
115
+ const record = await this.safeAuditRecord("tools/call", {
116
+ toolName,
117
+ namespace: tool.namespace,
118
+ upstream: tool.upstream,
119
+ principal,
120
+ durationMs,
121
+ success: true,
122
+ });
123
+ return { result, auditRecord: record };
124
+ }
125
+ catch (err) {
126
+ const durationMs = Date.now() - startTime;
127
+ this.tracer.recordDuration(span, durationMs);
128
+ this.tracer.endSpan(span, false);
129
+ this.metrics.recordToolCall({
130
+ namespace: tool.namespace,
131
+ tool: toolName,
132
+ principal: principal ?? "anonymous",
133
+ success: "false",
134
+ });
135
+ this.metrics.recordDuration(durationMs, {
136
+ namespace: tool.namespace,
137
+ upstream: tool.upstream,
138
+ });
139
+ if (err instanceof ToolCallError)
140
+ throw err;
141
+ const record = await this.safeAuditRecord("tools/call", {
142
+ toolName,
143
+ namespace: tool.namespace,
144
+ upstream: tool.upstream,
145
+ principal,
146
+ durationMs,
147
+ success: false,
148
+ errorCode: -32603,
149
+ });
150
+ throw new ToolCallError(-32603, "Upstream server error", record);
151
+ }
152
+ }
153
+ getStatus() {
154
+ const managed = this.upstreamManager.getAllStatuses();
155
+ const manual = this.manualStatuses ? Array.from(this.manualStatuses.values()) : [];
156
+ const upstreams = managed.length > 0 ? managed : manual;
157
+ return {
158
+ gateway: {
159
+ status: "healthy",
160
+ version: this.config.version,
161
+ },
162
+ upstreams,
163
+ aggregate: {
164
+ totalUpstreams: upstreams.length,
165
+ healthyUpstreams: upstreams.filter((u) => u.status === "healthy").length,
166
+ degradedUpstreams: upstreams.filter((u) => u.status === "degraded").length,
167
+ unavailableUpstreams: upstreams.filter((u) => u.status === "unavailable").length,
168
+ totalTools: this.toolCatalog.size,
169
+ },
170
+ };
171
+ }
172
+ getServerDiscover() {
173
+ return {
174
+ name: this.config.name,
175
+ version: this.config.version,
176
+ protocol: "2025-03-26",
177
+ capabilities: {
178
+ tools: { listChanged: true },
179
+ gateway: {
180
+ namespacing: true,
181
+ filtering: true,
182
+ routing: true,
183
+ healthReporting: true,
184
+ attestation: this.config.attestation.enabled,
185
+ upstreamCount: this.config.upstreams.length,
186
+ },
187
+ },
188
+ extensions: ["x-gateway-routing/v1", "x-gateway-attestation/v1"],
189
+ };
190
+ }
191
+ registerUpstreamTools(upstreamName, namespace, tools) {
192
+ for (const tool of tools) {
193
+ const namespacedName = `${namespace}/${tool.name}`;
194
+ const entry = {
195
+ name: namespacedName,
196
+ originalName: tool.name,
197
+ namespace,
198
+ upstream: upstreamName,
199
+ description: tool.description,
200
+ inputSchema: tool.inputSchema,
201
+ annotations: tool.annotations,
202
+ };
203
+ this.toolCatalog.set(namespacedName, entry);
204
+ }
205
+ if (!this.manualStatuses)
206
+ this.manualStatuses = new Map();
207
+ this.manualStatuses.set(upstreamName, {
208
+ name: upstreamName,
209
+ namespace,
210
+ status: "healthy",
211
+ toolCount: tools.length,
212
+ lastSuccessfulContact: new Date().toISOString(),
213
+ });
214
+ this.metrics.setUpstreamStatus(upstreamName, "healthy", 1);
215
+ }
216
+ async safeAuditRecord(method, opts) {
217
+ try {
218
+ return await this.auditLog.record(method, opts);
219
+ }
220
+ catch (err) {
221
+ console.error(`Audit log write failed: ${err}`);
222
+ return {
223
+ id: "unrecorded",
224
+ timestamp: new Date().toISOString(),
225
+ method,
226
+ ...opts,
227
+ attestation: undefined,
228
+ };
229
+ }
230
+ }
231
+ async shutdown() {
232
+ await this.upstreamManager.disconnectAll();
233
+ }
234
+ }
235
+ export class ToolCallError extends Error {
236
+ code;
237
+ auditRecord;
238
+ constructor(code, message, auditRecord) {
239
+ super(message);
240
+ this.code = code;
241
+ this.auditRecord = auditRecord;
242
+ this.name = "ToolCallError";
243
+ }
244
+ }
245
+ //# sourceMappingURL=gateway.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/proxy/gateway.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=gateway.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.test.d.ts","sourceRoot":"","sources":["../../src/proxy/gateway.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,93 @@
1
+ import { describe, it, expect, beforeEach } from "vitest";
2
+ import { Gateway } from "./gateway.js";
3
+ const testConfig = {
4
+ name: "test-gateway",
5
+ version: "0.1.0",
6
+ listen: { transport: "streamable-http", port: 3100, host: "127.0.0.1" },
7
+ upstreams: [
8
+ {
9
+ name: "test-server",
10
+ namespace: "test",
11
+ transport: { type: "stdio", command: "echo", args: [] },
12
+ },
13
+ ],
14
+ policy: {
15
+ defaultEffect: "allow",
16
+ rules: [
17
+ {
18
+ effect: "deny",
19
+ principals: ["agent:blocked"],
20
+ tools: ["test/dangerous_tool"],
21
+ },
22
+ ],
23
+ },
24
+ attestation: { enabled: true, algorithm: "hmac-sha256", secret: "a".repeat(64), includeParams: false, includeResult: false },
25
+ telemetry: { enabled: false, serviceName: "test", sampleRate: 0 },
26
+ auditLog: { enabled: true, path: "/tmp/test-audit.jsonl", rotateAfterMb: 10 },
27
+ };
28
+ describe("Gateway", () => {
29
+ let gateway;
30
+ beforeEach(async () => {
31
+ gateway = new Gateway(testConfig);
32
+ await gateway.init();
33
+ gateway.registerUpstreamTools("test-server", "test", [
34
+ { name: "safe_tool", description: "A safe tool" },
35
+ { name: "dangerous_tool", description: "A dangerous tool" },
36
+ { name: "read_data", description: "Read some data" },
37
+ ]);
38
+ });
39
+ describe("server/discover", () => {
40
+ it("advertises gateway capabilities", () => {
41
+ const discover = gateway.getServerDiscover();
42
+ expect(discover.capabilities).toHaveProperty("gateway");
43
+ const gw = discover.capabilities.gateway;
44
+ expect(gw.namespacing).toBe(true);
45
+ expect(gw.filtering).toBe(true);
46
+ expect(gw.routing).toBe(true);
47
+ expect(gw.attestation).toBe(true);
48
+ expect(gw.upstreamCount).toBe(1);
49
+ });
50
+ });
51
+ describe("tools/list", () => {
52
+ it("returns namespaced tools", async () => {
53
+ const result = await gateway.handleToolsList();
54
+ expect(result.tools).toHaveLength(3);
55
+ const names = result.tools.map((t) => t.name);
56
+ expect(names).toContain("test/safe_tool");
57
+ expect(names).toContain("test/dangerous_tool");
58
+ expect(names).toContain("test/read_data");
59
+ });
60
+ it("filters tools based on policy", async () => {
61
+ const result = await gateway.handleToolsList("agent:blocked");
62
+ const names = result.tools.map((t) => t.name);
63
+ expect(names).toContain("test/safe_tool");
64
+ expect(names).not.toContain("test/dangerous_tool");
65
+ expect(names).toContain("test/read_data");
66
+ });
67
+ it("includes filtering metadata", async () => {
68
+ const result = await gateway.handleToolsList("agent:blocked");
69
+ const meta = result._meta;
70
+ expect(meta["x-gateway-routing/v1"].filteringApplied).toBe(true);
71
+ expect(meta["x-gateway-routing/v1"].totalToolsPreFilter).toBe(3);
72
+ expect(meta["x-gateway-routing/v1"].totalToolsPostFilter).toBe(2);
73
+ });
74
+ });
75
+ describe("tools/call", () => {
76
+ it("rejects unknown tools", async () => {
77
+ await expect(gateway.handleToolsCall("nonexistent/tool", {})).rejects.toThrow("Unknown tool");
78
+ });
79
+ it("rejects unauthorized tool calls", async () => {
80
+ await expect(gateway.handleToolsCall("test/dangerous_tool", {}, "agent:blocked")).rejects.toThrow();
81
+ });
82
+ });
83
+ describe("status", () => {
84
+ it("reports gateway and upstream health", () => {
85
+ const status = gateway.getStatus();
86
+ expect(status.gateway.status).toBe("healthy");
87
+ expect(status.upstreams).toHaveLength(1);
88
+ expect(status.upstreams[0].name).toBe("test-server");
89
+ expect(status.aggregate.totalTools).toBe(3);
90
+ });
91
+ });
92
+ });
93
+ //# sourceMappingURL=gateway.test.js.map