@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.
- package/.github/workflows/npm-publish.yml +21 -0
- package/CONTRIBUTING.md +41 -0
- package/LICENSE +21 -0
- package/README.md +156 -0
- package/dist/attestation/audit-log.d.ts +25 -0
- package/dist/attestation/audit-log.d.ts.map +1 -0
- package/dist/attestation/audit-log.js +95 -0
- package/dist/attestation/audit-log.js.map +1 -0
- package/dist/attestation/bugfix.test.d.ts +2 -0
- package/dist/attestation/bugfix.test.d.ts.map +1 -0
- package/dist/attestation/bugfix.test.js +103 -0
- package/dist/attestation/bugfix.test.js.map +1 -0
- package/dist/attestation/chain.test.d.ts +2 -0
- package/dist/attestation/chain.test.d.ts.map +1 -0
- package/dist/attestation/chain.test.js +153 -0
- package/dist/attestation/chain.test.js.map +1 -0
- package/dist/attestation/keygen.d.ts +5 -0
- package/dist/attestation/keygen.d.ts.map +1 -0
- package/dist/attestation/keygen.js +12 -0
- package/dist/attestation/keygen.js.map +1 -0
- package/dist/attestation/signer.d.ts +25 -0
- package/dist/attestation/signer.d.ts.map +1 -0
- package/dist/attestation/signer.js +93 -0
- package/dist/attestation/signer.js.map +1 -0
- package/dist/attestation/signer.test.d.ts +2 -0
- package/dist/attestation/signer.test.d.ts.map +1 -0
- package/dist/attestation/signer.test.js +62 -0
- package/dist/attestation/signer.test.js.map +1 -0
- package/dist/attestation/verify.d.ts +26 -0
- package/dist/attestation/verify.d.ts.map +1 -0
- package/dist/attestation/verify.js +104 -0
- package/dist/attestation/verify.js.map +1 -0
- package/dist/attestation/verify.test.d.ts +2 -0
- package/dist/attestation/verify.test.d.ts.map +1 -0
- package/dist/attestation/verify.test.js +79 -0
- package/dist/attestation/verify.test.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +364 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.d.ts +12 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +12 -0
- package/dist/index.js.map +1 -0
- package/dist/integration.test.d.ts +2 -0
- package/dist/integration.test.d.ts.map +1 -0
- package/dist/integration.test.js +88 -0
- package/dist/integration.test.js.map +1 -0
- package/dist/policy/engine.d.ts +24 -0
- package/dist/policy/engine.d.ts.map +1 -0
- package/dist/policy/engine.js +130 -0
- package/dist/policy/engine.js.map +1 -0
- package/dist/policy/engine.test.d.ts +2 -0
- package/dist/policy/engine.test.d.ts.map +1 -0
- package/dist/policy/engine.test.js +80 -0
- package/dist/policy/engine.test.js.map +1 -0
- package/dist/proxy/gateway.d.ts +54 -0
- package/dist/proxy/gateway.d.ts.map +1 -0
- package/dist/proxy/gateway.js +245 -0
- package/dist/proxy/gateway.js.map +1 -0
- package/dist/proxy/gateway.test.d.ts +2 -0
- package/dist/proxy/gateway.test.d.ts.map +1 -0
- package/dist/proxy/gateway.test.js +93 -0
- package/dist/proxy/gateway.test.js.map +1 -0
- package/dist/proxy/mcp-server-adapter.d.ts +21 -0
- package/dist/proxy/mcp-server-adapter.d.ts.map +1 -0
- package/dist/proxy/mcp-server-adapter.js +98 -0
- package/dist/proxy/mcp-server-adapter.js.map +1 -0
- package/dist/proxy/mcp-server-adapter.test.d.ts +2 -0
- package/dist/proxy/mcp-server-adapter.test.d.ts.map +1 -0
- package/dist/proxy/mcp-server-adapter.test.js +160 -0
- package/dist/proxy/mcp-server-adapter.test.js.map +1 -0
- package/dist/proxy/upstream-manager.d.ts +49 -0
- package/dist/proxy/upstream-manager.d.ts.map +1 -0
- package/dist/proxy/upstream-manager.js +246 -0
- package/dist/proxy/upstream-manager.js.map +1 -0
- package/dist/proxy/upstream-manager.test.d.ts +2 -0
- package/dist/proxy/upstream-manager.test.d.ts.map +1 -0
- package/dist/proxy/upstream-manager.test.js +413 -0
- package/dist/proxy/upstream-manager.test.js.map +1 -0
- package/dist/telemetry/logger.d.ts +26 -0
- package/dist/telemetry/logger.d.ts.map +1 -0
- package/dist/telemetry/logger.js +48 -0
- package/dist/telemetry/logger.js.map +1 -0
- package/dist/telemetry/logger.test.d.ts +2 -0
- package/dist/telemetry/logger.test.d.ts.map +1 -0
- package/dist/telemetry/logger.test.js +124 -0
- package/dist/telemetry/logger.test.js.map +1 -0
- package/dist/telemetry/metrics.d.ts +41 -0
- package/dist/telemetry/metrics.d.ts.map +1 -0
- package/dist/telemetry/metrics.js +64 -0
- package/dist/telemetry/metrics.js.map +1 -0
- package/dist/telemetry/metrics.test.d.ts +2 -0
- package/dist/telemetry/metrics.test.d.ts.map +1 -0
- package/dist/telemetry/metrics.test.js +93 -0
- package/dist/telemetry/metrics.test.js.map +1 -0
- package/dist/telemetry/tracer.d.ts +16 -0
- package/dist/telemetry/tracer.d.ts.map +1 -0
- package/dist/telemetry/tracer.js +71 -0
- package/dist/telemetry/tracer.js.map +1 -0
- package/dist/types.d.ts +477 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +68 -0
- package/dist/types.js.map +1 -0
- package/dist/wrap/proxy.d.ts +2 -0
- package/dist/wrap/proxy.d.ts.map +1 -0
- package/dist/wrap/proxy.js +152 -0
- package/dist/wrap/proxy.js.map +1 -0
- package/dist/wrap/proxy.test.d.ts +2 -0
- package/dist/wrap/proxy.test.d.ts.map +1 -0
- package/dist/wrap/proxy.test.js +155 -0
- package/dist/wrap/proxy.test.js.map +1 -0
- package/examples/README.md +33 -0
- package/examples/claude-desktop.json +50 -0
- package/examples/multi-agent-production.json +72 -0
- package/gateway.config.example.json +61 -0
- package/package.json +49 -0
- package/src/attestation/audit-log.ts +126 -0
- package/src/attestation/bugfix.test.ts +113 -0
- package/src/attestation/chain.test.ts +188 -0
- package/src/attestation/keygen.ts +18 -0
- package/src/attestation/signer.test.ts +75 -0
- package/src/attestation/signer.ts +105 -0
- package/src/attestation/verify.test.ts +86 -0
- package/src/attestation/verify.ts +131 -0
- package/src/cli.ts +407 -0
- package/src/index.ts +21 -0
- package/src/integration.test.ts +108 -0
- package/src/policy/engine.test.ts +95 -0
- package/src/policy/engine.ts +162 -0
- package/src/proxy/gateway.test.ts +108 -0
- package/src/proxy/gateway.ts +328 -0
- package/src/proxy/mcp-server-adapter.test.ts +197 -0
- package/src/proxy/mcp-server-adapter.ts +140 -0
- package/src/proxy/upstream-manager.test.ts +534 -0
- package/src/proxy/upstream-manager.ts +326 -0
- package/src/telemetry/logger.test.ts +139 -0
- package/src/telemetry/logger.ts +72 -0
- package/src/telemetry/metrics.test.ts +125 -0
- package/src/telemetry/metrics.ts +83 -0
- package/src/telemetry/tracer.ts +90 -0
- package/src/types.ts +113 -0
- package/src/wrap/proxy.test.ts +175 -0
- package/src/wrap/proxy.ts +192 -0
- 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":"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"}
|
|
@@ -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 @@
|
|
|
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
|