@nativemind108/mcp 0.0.0-stage → 1.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 (90) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/LICENSE +289 -0
  3. package/NOTICE +5 -0
  4. package/README.md +53 -2
  5. package/dist/cjs/access.d.ts +41 -0
  6. package/dist/cjs/access.js +28 -0
  7. package/dist/cjs/access.js.map +1 -0
  8. package/dist/cjs/catalog.d.ts +21 -0
  9. package/dist/cjs/catalog.js +54 -0
  10. package/dist/cjs/catalog.js.map +1 -0
  11. package/dist/cjs/client.d.ts +67 -0
  12. package/dist/cjs/client.js +123 -0
  13. package/dist/cjs/client.js.map +1 -0
  14. package/dist/cjs/define.d.ts +50 -0
  15. package/dist/cjs/define.js +27 -0
  16. package/dist/cjs/define.js.map +1 -0
  17. package/dist/cjs/feedback.d.ts +21 -0
  18. package/dist/cjs/feedback.js +93 -0
  19. package/dist/cjs/feedback.js.map +1 -0
  20. package/dist/cjs/http.d.ts +15 -0
  21. package/dist/cjs/http.js +213 -0
  22. package/dist/cjs/http.js.map +1 -0
  23. package/dist/cjs/hub.d.ts +51 -0
  24. package/dist/cjs/hub.js +346 -0
  25. package/dist/cjs/hub.js.map +1 -0
  26. package/dist/cjs/index.d.ts +11 -0
  27. package/dist/cjs/index.js +29 -0
  28. package/dist/cjs/index.js.map +1 -0
  29. package/dist/cjs/options.d.ts +168 -0
  30. package/dist/cjs/options.js +3 -0
  31. package/dist/cjs/options.js.map +1 -0
  32. package/dist/cjs/output.d.ts +23 -0
  33. package/dist/cjs/output.js +88 -0
  34. package/dist/cjs/output.js.map +1 -0
  35. package/dist/cjs/package.json +3 -0
  36. package/dist/cjs/service.d.ts +68 -0
  37. package/dist/cjs/service.js +98 -0
  38. package/dist/cjs/service.js.map +1 -0
  39. package/dist/cjs/tools.d.ts +31 -0
  40. package/dist/cjs/tools.js +124 -0
  41. package/dist/cjs/tools.js.map +1 -0
  42. package/dist/esm/access.d.ts +42 -0
  43. package/dist/esm/access.d.ts.map +1 -0
  44. package/dist/esm/access.js +24 -0
  45. package/dist/esm/access.js.map +1 -0
  46. package/dist/esm/catalog.d.ts +22 -0
  47. package/dist/esm/catalog.d.ts.map +1 -0
  48. package/dist/esm/catalog.js +50 -0
  49. package/dist/esm/catalog.js.map +1 -0
  50. package/dist/esm/client.d.ts +68 -0
  51. package/dist/esm/client.d.ts.map +1 -0
  52. package/dist/esm/client.js +118 -0
  53. package/dist/esm/client.js.map +1 -0
  54. package/dist/esm/define.d.ts +51 -0
  55. package/dist/esm/define.d.ts.map +1 -0
  56. package/dist/esm/define.js +23 -0
  57. package/dist/esm/define.js.map +1 -0
  58. package/dist/esm/feedback.d.ts +22 -0
  59. package/dist/esm/feedback.d.ts.map +1 -0
  60. package/dist/esm/feedback.js +89 -0
  61. package/dist/esm/feedback.js.map +1 -0
  62. package/dist/esm/http.d.ts +16 -0
  63. package/dist/esm/http.d.ts.map +1 -0
  64. package/dist/esm/http.js +206 -0
  65. package/dist/esm/http.js.map +1 -0
  66. package/dist/esm/hub.d.ts +52 -0
  67. package/dist/esm/hub.d.ts.map +1 -0
  68. package/dist/esm/hub.js +337 -0
  69. package/dist/esm/hub.js.map +1 -0
  70. package/dist/esm/index.d.ts +12 -0
  71. package/dist/esm/index.d.ts.map +1 -0
  72. package/dist/esm/index.js +13 -0
  73. package/dist/esm/index.js.map +1 -0
  74. package/dist/esm/options.d.ts +169 -0
  75. package/dist/esm/options.d.ts.map +1 -0
  76. package/dist/esm/options.js +2 -0
  77. package/dist/esm/options.js.map +1 -0
  78. package/dist/esm/output.d.ts +24 -0
  79. package/dist/esm/output.d.ts.map +1 -0
  80. package/dist/esm/output.js +79 -0
  81. package/dist/esm/output.js.map +1 -0
  82. package/dist/esm/service.d.ts +69 -0
  83. package/dist/esm/service.d.ts.map +1 -0
  84. package/dist/esm/service.js +93 -0
  85. package/dist/esm/service.js.map +1 -0
  86. package/dist/esm/tools.d.ts +32 -0
  87. package/dist/esm/tools.d.ts.map +1 -0
  88. package/dist/esm/tools.js +118 -0
  89. package/dist/esm/tools.js.map +1 -0
  90. package/package.json +59 -4
@@ -0,0 +1,51 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { Catalog } from './catalog.js';
3
+ import { ApiClient } from './client.js';
4
+ import type { McpRoute, McpServiceOptions, RouteContext } from './options.js';
5
+ import { ResultStore } from './output.js';
6
+ import { type SessionInfo } from './access.js';
7
+ /** sha256 of a key: cache key of its catalog (the secret itself is never a map key). */
8
+ export declare function keyHash(apiKey: string): string;
9
+ /**
10
+ * State of one key (or of anonymous access): API client, catalog, result cache. Every MCP session of the key gets its own
11
+ * `Server`; catalog changes notify all of them (tools/list_changed).
12
+ */
13
+ export declare class KeyHub {
14
+ readonly options: McpServiceOptions;
15
+ readonly client: ApiClient;
16
+ readonly catalog: Catalog | null;
17
+ readonly store: ResultStore;
18
+ /** 1.1: each open session's descriptor, so toolsChanged(match) can pick sessions. */
19
+ private readonly servers;
20
+ private timer;
21
+ lastUsed: number;
22
+ constructor(options: McpServiceOptions, apiKey: string | null);
23
+ get sessions(): number;
24
+ private get refreshMs();
25
+ /** Loads the catalog when never loaded or stale; 401/403 propagate, other errors keep the last catalog. */
26
+ ensureFresh(): Promise<void>;
27
+ private notifyChanged;
28
+ /**
29
+ * 1.1: the product's rights changed (Konsilium: «Аккаунт → API», co-ownership …) → matching sessions get
30
+ * notifications/tools/list_changed and re-list (the policy is evaluated live). Returns how many were notified.
31
+ */
32
+ notifyToolsChanged(match?: (s: SessionInfo) => boolean): Promise<number>;
33
+ /** Re-reads the catalog; notifies sessions on change. Errors keep the last catalog. */
34
+ refresh(): Promise<boolean>;
35
+ startTimer(): void;
36
+ stop(): void;
37
+ /** An MCP server for one session of `route` with its params. */
38
+ createServer(route: McpRoute, params: Record<string, string>, lang: string | null, closeTimerWhenIdle: boolean, keyId: string | null, session?: Record<string, unknown>, request?: RouteContext['request']): Server;
39
+ }
40
+ /** HTTP mode: one KeyHub per key hash (+ one anonymous); idle hubs are evicted. */
41
+ export declare class HubPool {
42
+ readonly options: McpServiceOptions;
43
+ private readonly hubs;
44
+ constructor(options: McpServiceOptions);
45
+ get size(): number;
46
+ acquire(apiKey: string | null): Promise<KeyHub>;
47
+ private sweep;
48
+ /** 1.1: tools/list_changed to matching sessions of every hub (see KeyHub.notifyToolsChanged). */
49
+ notifyToolsChanged(match?: (s: SessionInfo) => boolean): Promise<number>;
50
+ stop(): void;
51
+ }
@@ -0,0 +1,346 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.HubPool = exports.KeyHub = void 0;
7
+ exports.keyHash = keyHash;
8
+ const node_crypto_1 = __importDefault(require("node:crypto"));
9
+ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
10
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
11
+ const zod_1 = require("zod");
12
+ const catalog_js_1 = require("./catalog.js");
13
+ const client_js_1 = require("./client.js");
14
+ const define_js_1 = require("./define.js");
15
+ const feedback_js_1 = require("./feedback.js");
16
+ const output_js_1 = require("./output.js");
17
+ const tools_js_1 = require("./tools.js");
18
+ const access_js_1 = require("./access.js");
19
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
20
+ /** sha256 of a key: cache key of its catalog (the secret itself is never a map key). */
21
+ function keyHash(apiKey) {
22
+ return node_crypto_1.default.createHash('sha256').update(apiKey).digest('hex');
23
+ }
24
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/server.ts KeyHub)
25
+ /**
26
+ * State of one key (or of anonymous access): API client, catalog, result cache. Every MCP session of the key gets its own
27
+ * `Server`; catalog changes notify all of them (tools/list_changed).
28
+ */
29
+ class KeyHub {
30
+ options;
31
+ client;
32
+ catalog;
33
+ store = new output_js_1.ResultStore();
34
+ /** 1.1: each open session's descriptor, so toolsChanged(match) can pick sessions. */
35
+ servers = new Map();
36
+ timer = null;
37
+ lastUsed = Date.now();
38
+ constructor(options, apiKey) {
39
+ this.options = options;
40
+ this.client = new client_js_1.ApiClient(options.api.url, apiKey, {
41
+ basePath: options.api.basePath,
42
+ ...(options.api.envelope ? { envelope: options.api.envelope } : {}),
43
+ ...(options.api.clientHeaders ? { clientHeaders: options.api.clientHeaders } : {}),
44
+ userAgent: options.api.userAgent ?? `${options.product.name}/${options.product.version ?? '1'}`,
45
+ ...(options.api.fetch ? { fetch: options.api.fetch } : {}),
46
+ });
47
+ this.catalog = options.catalog?.enabled && apiKey !== null ? new catalog_js_1.Catalog(this.client, options.catalog.toolsets ? new Set(options.catalog.toolsets) : null) : null;
48
+ }
49
+ get sessions() {
50
+ return this.servers.size;
51
+ }
52
+ get refreshMs() {
53
+ return this.options.catalog?.refreshMs ?? 60_000;
54
+ }
55
+ /** Loads the catalog when never loaded or stale; 401/403 propagate, other errors keep the last catalog. */
56
+ async ensureFresh() {
57
+ if (!this.catalog)
58
+ return;
59
+ if (!this.catalog.isLoaded) {
60
+ await this.catalog.refresh();
61
+ }
62
+ else if (Date.now() - this.catalog.loadedAt >= this.refreshMs) {
63
+ try {
64
+ const changed = await this.catalog.refresh();
65
+ if (changed)
66
+ await this.notifyChanged();
67
+ }
68
+ catch (error) {
69
+ if (error instanceof client_js_1.ApiCallError && (error.status === 401 || error.status === 403))
70
+ throw error;
71
+ }
72
+ }
73
+ }
74
+ async notifyChanged() {
75
+ await Promise.all([...this.servers.keys()].map((s) => s.sendToolListChanged().catch(() => undefined)));
76
+ }
77
+ // generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
78
+ /**
79
+ * 1.1: the product's rights changed (Konsilium: «Аккаунт → API», co-ownership …) → matching sessions get
80
+ * notifications/tools/list_changed and re-list (the policy is evaluated live). Returns how many were notified.
81
+ */
82
+ async notifyToolsChanged(match) {
83
+ const picked = [...this.servers].filter(([, info]) => !match || match(info)).map(([srv]) => srv);
84
+ await Promise.all(picked.map((srv) => srv.sendToolListChanged().catch(() => undefined)));
85
+ return picked.length;
86
+ }
87
+ /** Re-reads the catalog; notifies sessions on change. Errors keep the last catalog. */
88
+ async refresh() {
89
+ if (!this.catalog)
90
+ return false;
91
+ try {
92
+ const changed = await this.catalog.refresh();
93
+ if (changed)
94
+ await this.notifyChanged();
95
+ return changed;
96
+ }
97
+ catch {
98
+ return false;
99
+ }
100
+ }
101
+ startTimer() {
102
+ if (this.timer || !this.catalog)
103
+ return;
104
+ this.timer = setInterval(() => void this.refresh(), this.refreshMs);
105
+ this.timer.unref();
106
+ }
107
+ stop() {
108
+ if (this.timer)
109
+ clearInterval(this.timer);
110
+ this.timer = null;
111
+ }
112
+ /** An MCP server for one session of `route` with its params. */
113
+ createServer(route, params, lang, closeTimerWhenIdle, keyId, session = {}, request = null) {
114
+ const o = this.options;
115
+ // one client per session: per-session headers never leak between sessions sharing a key (or the anonymous hub)
116
+ const sessionApi = this.client.withHeaders({});
117
+ const routeCtx = { params, lang, api: sessionApi, session, request };
118
+ const instructions = typeof route.instructions === 'function' ? route.instructions(routeCtx) : (route.instructions ?? o.product.instructions);
119
+ const server = new index_js_1.Server({ name: route.serverName ?? o.product.name, version: o.product.version ?? '1.0.0' }, {
120
+ capabilities: { tools: { listChanged: true }, resources: o.resources?.subscribe ? { subscribe: true } : {}, ...(o.prompts ? { prompts: {} } : {}) },
121
+ ...(instructions ? { instructions } : {}),
122
+ });
123
+ this.servers.set(server, { route: route.path, params, session, keyHash: keyId });
124
+ this.lastUsed = Date.now();
125
+ this.startTimer();
126
+ const watches = new Map();
127
+ server.onclose = () => {
128
+ for (const stop of watches.values())
129
+ stop();
130
+ watches.clear();
131
+ this.servers.delete(server);
132
+ this.lastUsed = Date.now();
133
+ if (this.servers.size === 0 && closeTimerWhenIdle)
134
+ this.stop();
135
+ };
136
+ const limits = { maxRows: o.limits?.maxRows ?? 25, maxBytes: o.limits?.maxBytes ?? 8192, scheme: o.resultScheme ?? o.product.name.replace(/-mcp$/, '') };
137
+ const useCatalog = (route.catalog ?? o.catalog?.enabled ?? false) && this.catalog !== null;
138
+ const catalogOps = () => {
139
+ if (!useCatalog)
140
+ return [];
141
+ const ops = this.catalog.operations.filter((op) => !route.filter || route.filter(op, params));
142
+ return route.filterAll ? route.filterAll(ops, params) : ops;
143
+ };
144
+ const allManual = () => {
145
+ const own = route.tools?.(routeCtx) ?? [];
146
+ const fb = (0, feedback_js_1.feedbackTools)({ product: o.product.title, basePath: o.api.basePath, ...(o.feedback ?? {}) });
147
+ const names = new Set(own.map((t) => t.name));
148
+ return [...own, ...fb.filter((t) => !names.has(t.name))];
149
+ };
150
+ // 1.1: the access policy (live) — hidden tools are not listed and are refused on call
151
+ const policy = route.access ?? o.access;
152
+ const allowed = (t) => !policy || policy.allowed(t.requires, t.name, routeCtx);
153
+ const manual = () => allManual().filter(allowed);
154
+ const hidden = () => (policy ? allManual().filter((t) => !allowed(t)).map((t) => ({ name: t.name, needs: (0, access_js_1.needsOf)(t.requires), kind: t.requires?.kind ?? null })) : []);
155
+ const translate = (t) => {
156
+ if (!lang || !o.i18n)
157
+ return t;
158
+ const tr = o.i18n(t.name, lang);
159
+ if (!tr)
160
+ return t;
161
+ return { ...t, ...(tr.title ? { title: tr.title, annotations: { ...(t.annotations ?? {}), title: tr.title } } : {}), ...(tr.description ? { description: tr.description } : {}) };
162
+ };
163
+ const clientName = () => {
164
+ const ci = server.getClientVersion?.();
165
+ return ci?.name ? `${ci.name}${ci.version ? ` ${ci.version}` : ''}` : 'MCP';
166
+ };
167
+ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
168
+ if (useCatalog)
169
+ await this.ensureFresh().catch(() => undefined);
170
+ const ops = catalogOps();
171
+ const tools = ops.map((op) => (0, tools_js_1.catalogTool)(op, o.catalog ?? {}));
172
+ if (o.catalog?.jobs && (0, tools_js_1.hasJobs)(ops))
173
+ tools.push(...tools_js_1.JOB_TOOLS.filter((j) => !tools.some((t) => t.name === j.name)));
174
+ const seen = new Set(tools.map((t) => t.name));
175
+ for (const t of manual()) {
176
+ if (seen.has(t.name))
177
+ continue;
178
+ seen.add(t.name);
179
+ tools.push({ ...(t.listFields ?? {}), name: t.name, title: t.title, description: t.description, inputSchema: t.inputSchema, annotations: { title: t.title, ...(t.annotations ?? {}) } });
180
+ }
181
+ return { tools: tools.map(translate) };
182
+ });
183
+ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
184
+ const started = Date.now();
185
+ const name = req.params.name;
186
+ let result;
187
+ const callApi = sessionApi.withHeaders({ 'X-NM-MCP-Client': clientName() });
188
+ try {
189
+ const any = allManual().find((t) => t.name === name);
190
+ const tool = any && allowed(any) ? any : undefined;
191
+ if (any && !tool) {
192
+ result = (0, access_js_1.accessDeniedResult)(name, any.requires, policy?.refusal?.(name, any.requires, routeCtx));
193
+ }
194
+ else if (tool) {
195
+ const ctx = { api: callApi, params, lang, client: clientName(), extra: session, request, hidden };
196
+ try {
197
+ const args = tool.parse ? tool.parse(req.params.arguments ?? {}) : (req.params.arguments ?? {});
198
+ const value = await tool.call(args, ctx);
199
+ result = (0, define_js_1.isCallToolResult)(value) ? value : (0, output_js_1.toolResult)({ data: value }, limits, this.store);
200
+ }
201
+ catch (error) {
202
+ if (error instanceof zod_1.ZodError) {
203
+ result = (0, output_js_1.errorResult)(new client_js_1.ApiCallError(400, 'VALIDATION_ERROR', 'Invalid arguments.', error.issues.map((i) => ({ field: i.path.join('.'), reason: i.message }))));
204
+ }
205
+ else {
206
+ result = (0, output_js_1.errorResult)(error);
207
+ }
208
+ }
209
+ }
210
+ else {
211
+ const r = useCatalog
212
+ ? await (0, tools_js_1.callCatalogTool)({
213
+ api: callApi, store: this.store, limits, options: o.catalog ?? {},
214
+ ...(o.catalog?.rewriteArgs ? { rewriteArgs: o.catalog.rewriteArgs } : {}),
215
+ ...(o.catalog?.resultExtra ? { resultExtra: o.catalog.resultExtra } : {}),
216
+ onScopeDenied: () => void this.refresh(),
217
+ }, catalogOps(), name, req.params.arguments)
218
+ : null;
219
+ result = r ?? (0, output_js_1.errorResult)(new client_js_1.ApiCallError(404, 'UNKNOWN_TOOL', `Tool ${name} is not available here: unknown, not on this MCP endpoint, or not allowed for this key.`));
220
+ }
221
+ }
222
+ catch (error) {
223
+ result = (0, output_js_1.errorResult)(error);
224
+ }
225
+ const errorCode = result.isError ? (result.structuredContent?.error?.code ?? 'ERROR') : undefined;
226
+ o.onCall?.({ tool: name, route: route.path, ok: !result.isError, ms: Date.now() - started, keyHash: keyId, params, client: clientName(), session, ...(errorCode ? { errorCode } : {}) });
227
+ return result;
228
+ });
229
+ server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({ resources: (await o.resources?.list?.(sessionApi)) ?? [] }));
230
+ if (o.resources?.subscribe) {
231
+ const subscribe = o.resources.subscribe;
232
+ server.setRequestHandler(types_js_1.SubscribeRequestSchema, async (req) => {
233
+ const uri = req.params.uri;
234
+ if (watches.has(uri))
235
+ return {};
236
+ const stop = subscribe(uri, sessionApi, () => {
237
+ watches.delete(uri);
238
+ void server.sendResourceUpdated({ uri }).catch(() => undefined);
239
+ });
240
+ if (stop)
241
+ watches.set(uri, stop);
242
+ return {};
243
+ });
244
+ server.setRequestHandler(types_js_1.UnsubscribeRequestSchema, async (req) => {
245
+ watches.get(req.params.uri)?.();
246
+ watches.delete(req.params.uri);
247
+ return {};
248
+ });
249
+ }
250
+ server.setRequestHandler(types_js_1.ListResourceTemplatesRequestSchema, async () => ({
251
+ resourceTemplates: [
252
+ { uriTemplate: `${limits.scheme}://results/{token}`, name: 'Full tool result', mimeType: 'application/json', description: 'Full result of a truncated tool call' },
253
+ ...(o.resources?.templates?.() ?? []),
254
+ ],
255
+ }));
256
+ server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (req) => {
257
+ const uri = req.params.uri;
258
+ const m = new RegExp(`^${limits.scheme}://results/([A-Za-z0-9_-]+)$`).exec(uri);
259
+ if (m) {
260
+ const value = this.store.get(m[1]);
261
+ if (value === undefined)
262
+ throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `Unknown or expired result ${uri}`);
263
+ return { contents: [{ uri, mimeType: 'application/json', text: JSON.stringify(value) }] };
264
+ }
265
+ try {
266
+ const r = await o.resources?.read?.(uri, sessionApi);
267
+ if (r)
268
+ return r;
269
+ }
270
+ catch (error) {
271
+ const code = error instanceof client_js_1.ApiCallError ? error.code : 'MCP_ERROR';
272
+ throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `${code}: ${error instanceof Error ? error.message : String(error)}`);
273
+ }
274
+ throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `Unknown resource ${uri}`);
275
+ });
276
+ if (o.prompts) {
277
+ const prompts = o.prompts;
278
+ server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({ prompts: prompts.list() }));
279
+ server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (req) => {
280
+ try {
281
+ return prompts.get(req.params.name, req.params.arguments ?? {});
282
+ }
283
+ catch (error) {
284
+ throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, error instanceof Error ? error.message : String(error));
285
+ }
286
+ });
287
+ }
288
+ return server;
289
+ }
290
+ }
291
+ exports.KeyHub = KeyHub;
292
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/server.ts HubPool)
293
+ /** HTTP mode: one KeyHub per key hash (+ one anonymous); idle hubs are evicted. */
294
+ class HubPool {
295
+ options;
296
+ hubs = new Map();
297
+ constructor(options) {
298
+ this.options = options;
299
+ }
300
+ get size() {
301
+ return this.hubs.size;
302
+ }
303
+ async acquire(apiKey) {
304
+ this.sweep();
305
+ const hash = apiKey === null ? 'anonymous' : keyHash(apiKey);
306
+ let hub = this.hubs.get(hash);
307
+ if (!hub) {
308
+ hub = new KeyHub(this.options, apiKey);
309
+ this.hubs.set(hash, hub);
310
+ }
311
+ try {
312
+ await hub.ensureFresh();
313
+ }
314
+ catch (error) {
315
+ if (!hub.catalog?.isLoaded)
316
+ this.hubs.delete(hash);
317
+ throw error;
318
+ }
319
+ return hub;
320
+ }
321
+ sweep() {
322
+ const idleMs = Math.max(10 * (this.options.catalog?.refreshMs ?? 60_000), 10 * 60_000);
323
+ const now = Date.now();
324
+ for (const [hash, hub] of this.hubs) {
325
+ if (hub.sessions === 0 && now - hub.lastUsed > idleMs) {
326
+ hub.stop();
327
+ this.hubs.delete(hash);
328
+ }
329
+ }
330
+ }
331
+ // generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
332
+ /** 1.1: tools/list_changed to matching sessions of every hub (see KeyHub.notifyToolsChanged). */
333
+ async notifyToolsChanged(match) {
334
+ let n = 0;
335
+ for (const hub of this.hubs.values())
336
+ n += await hub.notifyToolsChanged(match);
337
+ return n;
338
+ }
339
+ stop() {
340
+ for (const hub of this.hubs.values())
341
+ hub.stop();
342
+ this.hubs.clear();
343
+ }
344
+ }
345
+ exports.HubPool = HubPool;
346
+ //# sourceMappingURL=hub.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub.js","sourceRoot":"","sources":["../../src/hub.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export * from './client.js';
2
+ export * from './catalog.js';
3
+ export * from './output.js';
4
+ export * from './define.js';
5
+ export * from './tools.js';
6
+ export * from './feedback.js';
7
+ export * from './options.js';
8
+ export * from './hub.js';
9
+ export * from './http.js';
10
+ export * from './service.js';
11
+ export * from './access.js';
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ // @nativemind108/mcp — public API. Authorship is marked at every declaration in the modules below.
18
+ __exportStar(require("./client.js"), exports);
19
+ __exportStar(require("./catalog.js"), exports);
20
+ __exportStar(require("./output.js"), exports);
21
+ __exportStar(require("./define.js"), exports);
22
+ __exportStar(require("./tools.js"), exports);
23
+ __exportStar(require("./feedback.js"), exports);
24
+ __exportStar(require("./options.js"), exports);
25
+ __exportStar(require("./hub.js"), exports);
26
+ __exportStar(require("./http.js"), exports);
27
+ __exportStar(require("./service.js"), exports);
28
+ __exportStar(require("./access.js"), exports);
29
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mGAAmG;AACnG,8CAA4B;AAC5B,+CAA6B;AAC7B,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,gDAA8B;AAC9B,+CAA6B;AAC7B,2CAAyB;AACzB,4CAA0B;AAC1B,+CAA6B;AAC7B,8CAA4B"}
@@ -0,0 +1,168 @@
1
+ import type { GetPromptResult, Prompt, ReadResourceResult, Resource, ResourceTemplate } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { Logger } from '@nativemind108/core';
3
+ import type { ApiClient, ApiEnvelope, CatalogOperation } from './client.js';
4
+ import type { ToolDefinition } from './define.js';
5
+ import type { AccessPolicy } from './access.js';
6
+ import type { FeedbackToolsOptions } from './feedback.js';
7
+ import type { CatalogToolOptions } from './tools.js';
8
+ /** Context of one MCP endpoint session (route params, language, client). */
9
+ export interface RouteContext {
10
+ params: Record<string, string>;
11
+ lang: string | null;
12
+ /** API client of this session (caller's bearer, per-session headers). */
13
+ api: ApiClient;
14
+ /** Data returned by the route's authorize() hook (Konsilium: access mode, project, enabled tools …). */
15
+ session: Record<string, unknown>;
16
+ /** The HTTP request that opened the session (null on stdio). */
17
+ request: {
18
+ ip: string;
19
+ headers: Record<string, unknown>;
20
+ } | null;
21
+ }
22
+ /** Result of McpRoute.authorize: session data, or a refusal with its own status / message / headers. */
23
+ export type AuthorizeResult = {
24
+ session?: Record<string, unknown>;
25
+ } | {
26
+ error: {
27
+ status: number;
28
+ message: string;
29
+ headers?: Record<string, string>;
30
+ };
31
+ };
32
+ /** One MCP endpoint. Default: a single route `/mcp` with the catalog tools. */
33
+ export interface McpRoute {
34
+ /** Fastify path: '/mcp', '/mcp/:group', '/mcp/p/:projectId'. */
35
+ path: string;
36
+ /** Anonymous access (no bearer; Konsilium /mcp/public). */
37
+ anonymous?: boolean;
38
+ /** Expose catalog tools here (default: options.catalog.enabled). */
39
+ catalog?: boolean;
40
+ /** Narrow the catalog for this route (dx groups: /mcp/{group}); false → 404 for unknown params. */
41
+ filter?: (op: CatalogOperation, params: Record<string, string>) => boolean;
42
+ /** Whole-list narrowing after `filter` (rules that need the full set, e.g. dx: refresh_wait only with other tools). */
43
+ filterAll?: (ops: CatalogOperation[], params: Record<string, string>) => CatalogOperation[];
44
+ /**
45
+ * Called when a session opens (HTTP): validate the bearer / params against the product and return session data
46
+ * (available as ctx.session / ToolCallContext.extra), or a refusal (custom 401/403/404 text).
47
+ */
48
+ authorize?: (req: {
49
+ ip: string;
50
+ headers: Record<string, unknown>;
51
+ query: Record<string, unknown>;
52
+ }, token: string | null, params: Record<string, string>, api: ApiClient) => Promise<AuthorizeResult> | AuthorizeResult;
53
+ /** Server name in initialize for this route (default product.name). */
54
+ serverName?: string;
55
+ /** Accept route params (e.g. a known group); false → 404. */
56
+ accepts?: (params: Record<string, string>) => boolean;
57
+ /** Hand-written tools of the route (Konsilium project / personal / manager tools). */
58
+ tools?: (ctx: RouteContext) => ToolDefinition[];
59
+ /** Server instructions (string or per session). */
60
+ instructions?: string | ((ctx: RouteContext) => string);
61
+ /** 1.1: access policy of this route's hand-written tools (default: options.access; none = every tool shown). */
62
+ access?: AccessPolicy;
63
+ }
64
+ export interface CallRecord {
65
+ tool: string;
66
+ route: string;
67
+ ok: boolean;
68
+ ms: number;
69
+ keyHash: string | null;
70
+ params: Record<string, string>;
71
+ /** MCP client `name version` (initialize clientInfo). */
72
+ client: string;
73
+ /** Error code of a failed call (no arguments or texts are recorded). */
74
+ errorCode?: string;
75
+ session: Record<string, unknown>;
76
+ }
77
+ export interface McpServiceOptions {
78
+ product: {
79
+ /** Server name in initialize (e.g. 'dx-mcp'). */
80
+ name: string;
81
+ /** Human product name in texts (e.g. 'dropexpired'). */
82
+ title: string;
83
+ version?: string;
84
+ instructions?: string;
85
+ };
86
+ api: {
87
+ url: string;
88
+ basePath: string;
89
+ /** 'none': the API answers plain bodies, not `{data, meta}` (Konsilium). */
90
+ envelope?: 'data' | 'none';
91
+ clientHeaders?: Record<string, string>;
92
+ userAgent?: string;
93
+ fetch?: typeof fetch;
94
+ };
95
+ transports: {
96
+ /** Stdio with one key (local clients). */
97
+ stdio?: {
98
+ apiKey: string | null;
99
+ };
100
+ http?: {
101
+ host: string;
102
+ port: number;
103
+ /** Public origin of this MCP endpoint (RFC 9728 resource + WWW-Authenticate). */
104
+ publicUrl?: string;
105
+ /** OAuth authorization server(s) for /.well-known/oauth-protected-resource; omit to not serve the metadata. */
106
+ authServers?: string[];
107
+ /** Extra fields of the protected-resource metadata (scopes_supported, resource_documentation …). */
108
+ resourceMetadata?: Record<string, unknown> | ((path: string, query: Record<string, unknown>) => Record<string, unknown>);
109
+ /** Accept JSON-RPC bodies sent as text/plain (clients that omit the JSON content type). */
110
+ lenientJson?: boolean;
111
+ /** Legacy HTTP+SSE transport (Konsilium clients): GET ssePath, POST messagesPath. */
112
+ legacySse?: {
113
+ ssePath: string;
114
+ messagesPath: string;
115
+ route?: string;
116
+ };
117
+ sessionIdleMs?: number;
118
+ maxSessions?: number;
119
+ };
120
+ };
121
+ catalog?: CatalogToolOptions & {
122
+ enabled: boolean;
123
+ /** Local narrowing of the key policy; null/undefined = all toolsets the key allows. */
124
+ toolsets?: string[] | null;
125
+ refreshMs?: number;
126
+ rewriteArgs?: (op: CatalogOperation, args: Record<string, unknown>) => Record<string, unknown>;
127
+ resultExtra?: (op: CatalogOperation, body: ApiEnvelope) => Record<string, unknown>;
128
+ };
129
+ routes?: McpRoute[];
130
+ /** Feedback tools are always on; these options only adjust the wording. */
131
+ feedback?: Omit<FeedbackToolsOptions, 'product' | 'basePath'>;
132
+ prompts?: {
133
+ list: () => Prompt[];
134
+ get: (name: string, args: Record<string, string>) => GetPromptResult;
135
+ };
136
+ resources?: {
137
+ list?: (api: ApiClient) => Promise<Resource[]>;
138
+ templates?: () => ResourceTemplate[];
139
+ read?: (uri: string, api: ApiClient) => Promise<ReadResourceResult | null>;
140
+ /** resources/subscribe: start watching `uri`; call notify() when it changed; return a stop function (dx: refresh handles). */
141
+ subscribe?: (uri: string, api: ApiClient, notify: () => void) => (() => void) | null;
142
+ };
143
+ /** Per-tool i18n of title / description (Konsilium: language of the key or ?lang=). */
144
+ i18n?: (toolName: string, lang: string) => {
145
+ title?: string;
146
+ description?: string;
147
+ } | null;
148
+ /** Language of an HTTP request (default: ?lang=). */
149
+ langOf?: (query: Record<string, unknown>, headers: Record<string, unknown>) => string | null;
150
+ /** Bearer tokens this MCP accepts (default: any non-empty); others get 401 before reaching the API. */
151
+ acceptToken?: (token: string) => boolean;
152
+ /** OAuth access tokens rotate: the grant id of a token, so a session continues after refresh. */
153
+ oauth?: {
154
+ isOAuthToken: (token: string) => boolean;
155
+ identity: (api: ApiClient) => Promise<string | null>;
156
+ };
157
+ /** Tool call log without arguments (Konsilium calllog). */
158
+ onCall?: (rec: CallRecord) => void;
159
+ limits?: {
160
+ maxRows?: number;
161
+ maxBytes?: number;
162
+ };
163
+ /** URI scheme of truncated results (default product.name without '-mcp'). */
164
+ resultScheme?: string;
165
+ logger?: Logger;
166
+ /** 1.1 (sdd-konsilium-mcp-local): default access policy of all routes (a route's own `access` wins). */
167
+ access?: AccessPolicy;
168
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=options.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/options.ts"],"names":[],"mappings":""}