@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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"write-confirmation.d.ts","sourceRoot":"","sources":["../src/write-confirmation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,207 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.MCP_CONFIRMATION_RECEIPTS_TABLE_SQL = exports.CONFIRMATION_UNAVAILABLE_ERROR_CODE = void 0;
4
+ exports.canonicalizeJson = canonicalizeJson;
5
+ exports.computeArgsDigest = computeArgsDigest;
6
+ exports.parseConfirmationRequestStatePayload = parseConfirmationRequestStatePayload;
7
+ exports.insertPendingConfirmationReceipt = insertPendingConfirmationReceipt;
8
+ exports.lockConfirmationReceiptForUpdate = lockConfirmationReceiptForUpdate;
9
+ exports.transitionConfirmationReceipt = transitionConfirmationReceipt;
10
+ exports.expirePendingConfirmationReceipts = expirePendingConfirmationReceipts;
11
+ exports.emitConfirmationAuditEvent = emitConfirmationAuditEvent;
12
+ const node_crypto_1 = require("node:crypto");
13
+ exports.CONFIRMATION_UNAVAILABLE_ERROR_CODE = -32092;
14
+ /**
15
+ * Test and tooling DDL. It must stay identical (apart from IF NOT EXISTS) to what
16
+ * `prisma migrate diff --from-empty` generates for prisma/mcp-rate-limit.prisma, which is what
17
+ * App migrations create; prisma-fragment.spec.ts guards the column types and defaults.
18
+ */
19
+ exports.MCP_CONFIRMATION_RECEIPTS_TABLE_SQL = `
20
+ CREATE TABLE IF NOT EXISTS "mcp_confirmation_receipts" (
21
+ "operation_id" TEXT NOT NULL,
22
+ "correlation_id" TEXT NOT NULL,
23
+ "status" TEXT NOT NULL,
24
+ "issuer" TEXT NOT NULL,
25
+ "subject" TEXT NOT NULL,
26
+ "acting_user_id" TEXT NOT NULL,
27
+ "client_id" TEXT NOT NULL,
28
+ "resource" TEXT NOT NULL,
29
+ "tool_name" TEXT NOT NULL,
30
+ "schema_version" INTEGER NOT NULL,
31
+ "args_digest" TEXT NOT NULL,
32
+ "expires_at" TIMESTAMPTZ(3) NOT NULL,
33
+ "result_json" JSONB,
34
+ "created_at" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
35
+ "updated_at" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
36
+ CONSTRAINT "mcp_confirmation_receipts_pkey" PRIMARY KEY ("operation_id")
37
+ );
38
+ CREATE INDEX IF NOT EXISTS "mcp_confirmation_receipts_status_expires_at_idx" ON "mcp_confirmation_receipts"("status", "expires_at");
39
+ `.trim();
40
+ /**
41
+ * Produces a deterministic canonical JSON representation for normalized tool arguments
42
+ * so `argsDigest` is stable regardless of object key insertion order.
43
+ */
44
+ function canonicalizeJson(value) {
45
+ if (value === null || value === undefined) {
46
+ return 'null';
47
+ }
48
+ if (value instanceof Date) {
49
+ return JSON.stringify(value.toISOString());
50
+ }
51
+ if (typeof value === 'boolean' || typeof value === 'number' || typeof value === 'string') {
52
+ return JSON.stringify(value);
53
+ }
54
+ if (typeof value === 'bigint') {
55
+ return JSON.stringify(value.toString());
56
+ }
57
+ if (Array.isArray(value)) {
58
+ const items = value.map((item) => (item === undefined ? 'null' : canonicalizeJson(item)));
59
+ return `[${items.join(',')}]`;
60
+ }
61
+ if (typeof value === 'object') {
62
+ const record = value;
63
+ const keys = Object.keys(record)
64
+ .filter((key) => record[key] !== undefined)
65
+ .sort();
66
+ const entries = keys.map((key) => `${JSON.stringify(key)}:${canonicalizeJson(record[key])}`);
67
+ return `{${entries.join(',')}}`;
68
+ }
69
+ return JSON.stringify(String(value));
70
+ }
71
+ function computeArgsDigest(normalizedArgs) {
72
+ return (0, node_crypto_1.createHash)('sha256').update(canonicalizeJson(normalizedArgs), 'utf8').digest('hex');
73
+ }
74
+ function parseConfirmationRequestStatePayload(raw) {
75
+ if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
76
+ return null;
77
+ }
78
+ const candidate = raw;
79
+ if (typeof candidate.toolName !== 'string' ||
80
+ candidate.toolName.length === 0 ||
81
+ typeof candidate.schemaVersion !== 'number' ||
82
+ !Number.isInteger(candidate.schemaVersion) ||
83
+ candidate.schemaVersion <= 0 ||
84
+ typeof candidate.argsDigest !== 'string' ||
85
+ candidate.argsDigest.length === 0 ||
86
+ typeof candidate.operationId !== 'string' ||
87
+ candidate.operationId.length === 0) {
88
+ return null;
89
+ }
90
+ return {
91
+ toolName: candidate.toolName,
92
+ schemaVersion: candidate.schemaVersion,
93
+ argsDigest: candidate.argsDigest,
94
+ operationId: candidate.operationId,
95
+ };
96
+ }
97
+ function mapReceiptRow(row) {
98
+ const expiresAt = row.expires_at instanceof Date ? row.expires_at : new Date(row.expires_at);
99
+ let resultJson = row.result_json;
100
+ if (typeof resultJson === 'string') {
101
+ try {
102
+ resultJson = JSON.parse(resultJson);
103
+ }
104
+ catch {
105
+ // keep raw string if already non-JSON
106
+ }
107
+ }
108
+ return {
109
+ operationId: row.operation_id,
110
+ correlationId: row.correlation_id,
111
+ status: row.status,
112
+ issuer: row.issuer,
113
+ subject: row.subject,
114
+ actingUserId: row.acting_user_id,
115
+ clientId: row.client_id,
116
+ resource: row.resource,
117
+ toolName: row.tool_name,
118
+ schemaVersion: Number(row.schema_version),
119
+ argsDigest: row.args_digest,
120
+ expiresAt,
121
+ resultJson,
122
+ };
123
+ }
124
+ async function insertPendingConfirmationReceipt(tx, receipt) {
125
+ await tx.$executeRawUnsafe(`INSERT INTO mcp_confirmation_receipts (
126
+ operation_id, correlation_id, status, issuer, subject, acting_user_id,
127
+ client_id, resource, tool_name, schema_version, args_digest, expires_at
128
+ ) VALUES ($1, $2, 'pending', $3, $4, $5, $6, $7, $8, $9, $10, $11)`, receipt.operationId, receipt.correlationId, receipt.issuer, receipt.subject, receipt.actingUserId, receipt.clientId, receipt.resource, receipt.toolName, receipt.schemaVersion, receipt.argsDigest, receipt.expiresAt);
129
+ }
130
+ async function lockConfirmationReceiptForUpdate(tx, operationId) {
131
+ const rows = await tx.$queryRawUnsafe(`SELECT operation_id, correlation_id, status, issuer, subject, acting_user_id,
132
+ client_id, resource, tool_name, schema_version, args_digest, expires_at, result_json
133
+ FROM mcp_confirmation_receipts
134
+ WHERE operation_id = $1
135
+ FOR UPDATE`, operationId);
136
+ const row = rows[0];
137
+ return row ? mapReceiptRow(row) : null;
138
+ }
139
+ async function transitionConfirmationReceipt(tx, params) {
140
+ const serializedResult = params.resultJson === undefined ? null : JSON.stringify(params.resultJson);
141
+ const rows = await tx.$queryRawUnsafe(`UPDATE mcp_confirmation_receipts
142
+ SET status = $2,
143
+ result_json = CASE WHEN $3::text IS NULL THEN result_json ELSE $3::jsonb END,
144
+ updated_at = NOW()
145
+ WHERE operation_id = $1 AND status = 'pending'
146
+ RETURNING operation_id`, params.operationId, params.nextStatus, serializedResult);
147
+ return rows.length === 1;
148
+ }
149
+ /**
150
+ * Transitions all `pending` confirmation receipts whose `expires_at <= now` to `expired`
151
+ * using a single atomic `UPDATE ... WHERE status = 'pending'` statement, and optionally emits
152
+ * `confirmation_expired` audit events for each transitioned row.
153
+ */
154
+ async function expirePendingConfirmationReceipts(prisma, options = {}) {
155
+ const now = options.now ?? new Date();
156
+ const rows = await prisma.$queryRawUnsafe(`UPDATE mcp_confirmation_receipts
157
+ SET status = 'expired',
158
+ updated_at = NOW()
159
+ WHERE status = 'pending' AND expires_at <= $1
160
+ RETURNING operation_id, correlation_id, issuer, subject, acting_user_id,
161
+ client_id, resource, tool_name`, now);
162
+ const expired = rows.map((row) => ({
163
+ operationId: row.operation_id,
164
+ correlationId: row.correlation_id,
165
+ issuer: row.issuer,
166
+ subject: row.subject,
167
+ actingUserId: row.acting_user_id,
168
+ clientId: row.client_id,
169
+ resource: row.resource,
170
+ toolName: row.tool_name,
171
+ }));
172
+ if (options.logger) {
173
+ for (const item of expired) {
174
+ emitConfirmationAuditEvent(options.logger, {
175
+ event: 'confirmation_expired',
176
+ correlationId: item.correlationId,
177
+ operationId: item.operationId,
178
+ resource: item.resource,
179
+ issuer: item.issuer,
180
+ subject: item.subject,
181
+ actingUserId: item.actingUserId,
182
+ clientId: item.clientId,
183
+ toolName: item.toolName,
184
+ resultCode: 'expired',
185
+ workflowId: null,
186
+ });
187
+ }
188
+ }
189
+ return expired;
190
+ }
191
+ function emitConfirmationAuditEvent(logger, event) {
192
+ const payload = {
193
+ ...event,
194
+ timestamp: new Date().toISOString(),
195
+ };
196
+ const line = JSON.stringify(payload);
197
+ if (event.event === 'confirmation_authz_denied' ||
198
+ event.event === 'confirmation_write_failed' ||
199
+ event.event === 'confirmation_gate_rejected' ||
200
+ event.event === 'confirmation_binding_rejected') {
201
+ logger.warn(line);
202
+ }
203
+ else {
204
+ logger.log(line);
205
+ }
206
+ }
207
+ //# sourceMappingURL=write-confirmation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"write-confirmation.js","sourceRoot":"","sources":["../src/write-confirmation.ts"],"names":[],"mappings":"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"}
@@ -5,34 +5,42 @@
5
5
  "cardinality": "singleton",
6
6
  "distribution": "official",
7
7
  "engine": {
8
- "haneinfoPluginApi": "^1.22.0",
8
+ "haneinfoPluginApi": "^1.29.0",
9
9
  "node": ">=22.0.0",
10
10
  "frameworks": {
11
- "@nestjs/common": "^11.0.5",
12
- "@nestjs/core": "^11.0.5",
13
- "@prisma/client": "^6.2.0",
11
+ "@nestjs/common": "^11.0.5 || ^12.0.0",
12
+ "@nestjs/core": "^11.0.5 || ^12.0.0",
13
+ "@prisma/client": "^6.2.0 || ^7.10.1",
14
14
  "express": "^5.0.0",
15
15
  "zod": "^4.4.3"
16
16
  }
17
17
  },
18
18
  "provides": ["haneinfo.mcp-tools"],
19
- "requires": ["haneinfo.principal-context"],
20
- "optionalRequires": [
21
- "haneinfo.audit-sink",
22
- "haneinfo.machine-auth-provider",
23
- "haneinfo.scope-matcher",
24
- "haneinfo.settings"
19
+ "requires": [
20
+ "haneinfo.iam-profile",
21
+ "haneinfo.oidc-identity-lookup",
22
+ "haneinfo.identity-store",
23
+ "haneinfo.rbac-policy"
25
24
  ],
25
+ "optionalRequires": ["haneinfo.audit-sink", "haneinfo.scope-matcher", "haneinfo.settings"],
26
+ "configSchema": {
27
+ "configRef": "iam"
28
+ },
26
29
  "facets": {
27
30
  "backend": {
28
31
  "modulePath": "./dist/mcp.module.js",
29
32
  "exportName": "McpModule",
30
- "controllerRoutes": ["mcp"],
33
+ "controllerRoutes": ["mcp", "mcp/admin"],
31
34
  "providerTokens": ["haneinfo.mcp-tools"]
32
35
  },
33
36
  "operations": {
34
37
  "healthIndicatorId": "mcp-server",
35
38
  "shutdownTimeoutMs": 5000
39
+ },
40
+ "prisma": {
41
+ "owns": ["McpRateLimitBucket", "McpConfirmationReceipt"],
42
+ "schemaFragment": "prisma/mcp-rate-limit.prisma",
43
+ "schemaDigest": "sha256:bb7afc961d105466ed7d901904bf72e0e87b384c6f07494ee3f7900468036643"
36
44
  }
37
45
  }
38
46
  }
package/package.json CHANGED
@@ -1,10 +1,11 @@
1
1
  {
2
2
  "name": "@haneinfo/mcp-server",
3
- "version": "3.5.0",
3
+ "version": "4.0.0",
4
4
  "private": false,
5
5
  "type": "commonjs",
6
6
  "files": [
7
7
  "dist",
8
+ "prisma",
8
9
  "haneinfo.plugin.json",
9
10
  "plugin.js",
10
11
  "plugin.d.ts"
@@ -21,35 +22,45 @@
21
22
  "default": "./dist/plugin.js"
22
23
  },
23
24
  "./haneinfo.plugin.json": "./haneinfo.plugin.json",
25
+ "./prisma/mcp-rate-limit.prisma": "./prisma/mcp-rate-limit.prisma",
24
26
  "./package.json": "./package.json"
25
27
  },
26
28
  "dependencies": {
27
29
  "@modelcontextprotocol/node": "2.1.2",
28
30
  "@modelcontextprotocol/server": "2.4.0",
29
31
  "hono": "^4.12.34",
30
- "@haneinfo/plugin-api": "^1.28.0",
31
- "@haneinfo/plugin-host-nest": "^2.1.1"
32
+ "jsonwebtoken": "^9.0.2",
33
+ "jwks-rsa": "^3.1.0",
34
+ "@haneinfo/commands": "0.1.0",
35
+ "@haneinfo/plugin-api": "^1.29.0",
36
+ "@haneinfo/plugin-host-nest": "^2.2.0"
32
37
  },
33
38
  "peerDependencies": {
39
+ "@haneinfo/common": "^0.6.1 || ^0.7.0",
34
40
  "@haneinfo/plugin-host-nest": "^2.0.0",
35
- "@nestjs/common": "^11.0.0",
36
- "@nestjs/core": "^11.0.0",
37
- "@prisma/client": "^6.19.0",
41
+ "@nestjs/common": "^11.0.0 || ^12.0.0",
42
+ "@nestjs/core": "^11.0.0 || ^12.0.0",
43
+ "@prisma/client": "^6.19.0 || ^7.10.1",
38
44
  "express": "^5.1.0",
39
45
  "zod": "^4.4.0"
40
46
  },
41
47
  "devDependencies": {
42
- "@nestjs/common": "^11.0.0",
43
- "@nestjs/core": "^11.0.0",
44
- "@nestjs/platform-express": "^11.0.0",
45
- "@nestjs/testing": "^11.0.0",
46
- "@prisma/client": "^6.19.0",
48
+ "@nestjs/common": "^12.3.2",
49
+ "@nestjs/core": "^12.3.2",
50
+ "@nestjs/platform-express": "^12.3.2",
51
+ "@nestjs/testing": "^12.3.2",
52
+ "@prisma/client": "^7.10.1",
47
53
  "@types/express": "^5.0.6",
54
+ "@types/jsonwebtoken": "^9.0.7",
48
55
  "@types/node": "^24.13.0",
56
+ "@types/pg": "8.23.1",
49
57
  "express": "^5.1.0",
58
+ "pg": "8.23.1",
50
59
  "typescript": "^5.9.3",
51
60
  "vitest": "^4.1.11",
52
61
  "zod": "^4.4.0",
62
+ "@haneinfo/common": "0.7.0",
63
+ "@haneinfo/iam-keycloak": "0.1.0",
53
64
  "@haneinfo/plugin-testkit": "2.3.1"
54
65
  },
55
66
  "license": "UNLICENSED",
@@ -61,6 +72,7 @@
61
72
  "build": "tsc -p tsconfig.build.json",
62
73
  "dev": "tsc -p tsconfig.build.json --watch",
63
74
  "test": "vitest run",
75
+ "test:pg": "tsc -p tsconfig.build.json && vitest run src/pg-rate-limiter.pg.spec.ts src/write-confirmation.pg.spec.ts",
64
76
  "typecheck": "tsc --noEmit"
65
77
  }
66
78
  }
@@ -0,0 +1,34 @@
1
+ /// Cross-replica fixed-window rate limit buckets for `@haneinfo/mcp-server` (1A §5).
2
+ model McpRateLimitBucket {
3
+ bucket String
4
+ keyHash String @map("key_hash")
5
+ windowStart DateTime @map("window_start") @db.Timestamptz(3)
6
+ used Int
7
+
8
+ @@id([bucket, keyHash, windowStart])
9
+ @@index([windowStart])
10
+ @@map("mcp_rate_limit_buckets")
11
+ }
12
+
13
+ /// Write-confirmation receipts for `@haneinfo/mcp-server` (1A §6, W5-06).
14
+ model McpConfirmationReceipt {
15
+ operationId String @id @map("operation_id")
16
+ correlationId String @map("correlation_id")
17
+ status String
18
+ issuer String
19
+ subject String
20
+ actingUserId String @map("acting_user_id")
21
+ clientId String @map("client_id")
22
+ resource String
23
+ toolName String @map("tool_name")
24
+ schemaVersion Int @map("schema_version")
25
+ argsDigest String @map("args_digest")
26
+ expiresAt DateTime @map("expires_at") @db.Timestamptz(3)
27
+ resultJson Json? @map("result_json")
28
+ createdAt DateTime @default(now()) @map("created_at") @db.Timestamptz(3)
29
+ /// Raw SQL writes these rows, so the database must supply the value (Prisma @updatedAt alone has no default).
30
+ updatedAt DateTime @default(now()) @updatedAt @map("updated_at") @db.Timestamptz(3)
31
+
32
+ @@index([status, expiresAt])
33
+ @@map("mcp_confirmation_receipts")
34
+ }