@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,23 @@
1
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import { type ApiEnvelope } from './client.js';
3
+ /** Full results that did not fit into a tool result, readable as `<scheme>://results/{token}` (LRU). */
4
+ export declare class ResultStore {
5
+ private readonly capacity;
6
+ private readonly items;
7
+ constructor(capacity?: number);
8
+ put(value: unknown): string;
9
+ get(token: string): unknown;
10
+ }
11
+ export interface OutputLimits {
12
+ maxRows: number;
13
+ maxBytes: number;
14
+ /** URI scheme of stored results ('dx', 'pbn', 'dealapp', 'konsilium'). */
15
+ scheme: string;
16
+ }
17
+ /**
18
+ * `structuredContent = { data, page?, … }`, text = compact JSON ≤ maxBytes. Oversized array results keep the first rows that fit
19
+ * (≤ maxRows) and point at the full result via a `<scheme>://results/{token}` resource. `extra` adds fields (dx: refresh).
20
+ */
21
+ export declare function toolResult(body: ApiEnvelope, limits: OutputLimits, store: ResultStore, extra?: Record<string, unknown>): CallToolResult;
22
+ /** API errors become tool results the agent can react to (never protocol-level failures). */
23
+ export declare function errorResult(error: unknown, message?: string): CallToolResult;
@@ -0,0 +1,88 @@
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.ResultStore = void 0;
7
+ exports.toolResult = toolResult;
8
+ exports.errorResult = errorResult;
9
+ const node_crypto_1 = __importDefault(require("node:crypto"));
10
+ const client_js_1 = require("./client.js");
11
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/output.ts)
12
+ /** Full results that did not fit into a tool result, readable as `<scheme>://results/{token}` (LRU). */
13
+ class ResultStore {
14
+ capacity;
15
+ items = new Map();
16
+ constructor(capacity = 50) {
17
+ this.capacity = capacity;
18
+ }
19
+ put(value) {
20
+ const token = node_crypto_1.default.randomBytes(9).toString('base64url');
21
+ this.items.set(token, value);
22
+ while (this.items.size > this.capacity)
23
+ this.items.delete(this.items.keys().next().value);
24
+ return token;
25
+ }
26
+ get(token) {
27
+ return this.items.get(token);
28
+ }
29
+ }
30
+ exports.ResultStore = ResultStore;
31
+ const size = (value) => Buffer.byteLength(JSON.stringify(value));
32
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
33
+ /**
34
+ * `structuredContent = { data, page?, … }`, text = compact JSON ≤ maxBytes. Oversized array results keep the first rows that fit
35
+ * (≤ maxRows) and point at the full result via a `<scheme>://results/{token}` resource. `extra` adds fields (dx: refresh).
36
+ */
37
+ function toolResult(body, limits, store, extra = {}) {
38
+ const page = body.meta?.page;
39
+ const full = { data: body.data, ...(page ? { page } : {}), ...extra };
40
+ if (size(full) <= limits.maxBytes && (!Array.isArray(body.data) || body.data.length <= limits.maxRows)) {
41
+ return { content: [{ type: 'text', text: JSON.stringify(full) }], structuredContent: full };
42
+ }
43
+ const token = store.put(full);
44
+ const uri = `${limits.scheme}://results/${token}`;
45
+ let shown;
46
+ let truncated;
47
+ if (Array.isArray(body.data)) {
48
+ const rows = body.data.slice(0, limits.maxRows);
49
+ while (rows.length > 1 && size(rows) > limits.maxBytes - 600)
50
+ rows.pop();
51
+ shown = rows;
52
+ truncated = {
53
+ returned: rows.length, total: body.data.length, nextCursor: page?.nextCursor ?? null, resource: uri,
54
+ hint: page?.nextCursor ? 'Call again with cursor=nextCursor for the next page, or read the resource for everything returned here.' : 'Read the resource for the full result, or narrow the request (filter/fields/limit).',
55
+ };
56
+ }
57
+ else {
58
+ const text = JSON.stringify(body.data);
59
+ shown = { preview: `${text.slice(0, Math.max(0, limits.maxBytes - 600))}…` };
60
+ truncated = { bytes: Buffer.byteLength(text), resource: uri, hint: 'Result is larger than the tool output limit; read the resource for the full JSON.' };
61
+ }
62
+ const result = { data: shown, ...(page ? { page } : {}), ...extra, truncated };
63
+ return {
64
+ content: [
65
+ { type: 'text', text: JSON.stringify(result) },
66
+ { type: 'resource_link', uri, name: `result-${token}`, mimeType: 'application/json', description: 'Full result of this tool call' },
67
+ ],
68
+ structuredContent: result,
69
+ };
70
+ }
71
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
72
+ /** API errors become tool results the agent can react to (never protocol-level failures). */
73
+ function errorResult(error, message) {
74
+ const payload = error instanceof client_js_1.ApiCallError
75
+ ? {
76
+ error: {
77
+ code: error.code,
78
+ status: error.status,
79
+ message: message ?? error.message,
80
+ details: error.details,
81
+ ...(error.preview !== undefined ? { preview: error.preview, hint: 'Nothing was changed. Review the preview and call the tool again with "confirm": true to execute.' } : {}),
82
+ ...(error.requestId ? { requestId: error.requestId } : {}),
83
+ },
84
+ }
85
+ : { error: { code: 'MCP_ERROR', message: message ?? (error instanceof Error ? error.message : String(error)) } };
86
+ return { isError: true, content: [{ type: 'text', text: `${payload.error.code}: ${payload.error.message}\n${JSON.stringify(payload)}` }], structuredContent: payload };
87
+ }
88
+ //# sourceMappingURL=output.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/output.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ {
2
+ "type": "commonjs"
3
+ }
@@ -0,0 +1,68 @@
1
+ import type { McpServiceOptions } from './options.js';
2
+ import type { SessionInfo } from './access.js';
3
+ export interface McpService {
4
+ close(): Promise<void>;
5
+ /** HTTP mode: the fastify app (tests use app.inject / app.server). */
6
+ app?: import('fastify').FastifyInstance;
7
+ /** 1.1: rights changed → matching open sessions get notifications/tools/list_changed; returns the count. */
8
+ toolsChanged(match?: (s: SessionInfo) => boolean): Promise<number>;
9
+ }
10
+ /** Starts the MCP service: Streamable HTTP when `transports.http` is set, else stdio. */
11
+ export declare function startMcpService(options: McpServiceOptions): Promise<McpService>;
12
+ export interface EnvConfig {
13
+ apiUrl: string;
14
+ publicUrl: string | undefined;
15
+ apiKey: string | null;
16
+ http: {
17
+ host: string;
18
+ port: number;
19
+ } | null;
20
+ toolsets: string[] | null;
21
+ maxRows: number;
22
+ maxBytes: number;
23
+ refreshMs: number;
24
+ authServers: string[];
25
+ }
26
+ /**
27
+ * NM_MCP_* configuration; `legacyPrefix` keeps old names working as aliases (spec S3: 'DX_MCP' → DX_MCP_API_URL …;
28
+ * PBN passes a map because its names differ).
29
+ */
30
+ export declare function mcpConfigFromEnv(env?: NodeJS.ProcessEnv, argv?: string[], legacy?: {
31
+ prefix?: string;
32
+ names?: Record<string, string[]>;
33
+ }, defaults?: {
34
+ apiUrl?: string;
35
+ port?: number;
36
+ },
37
+ /** 1.1: allowNoKey — stdio without a key is valid (a local MCP with only local tools, e.g. @consilium108/mcp offline). */
38
+ opts?: {
39
+ allowNoKey?: boolean;
40
+ }): EnvConfig;
41
+ export interface CliOptions {
42
+ argv?: string[];
43
+ env?: NodeJS.ProcessEnv;
44
+ legacy?: {
45
+ prefix?: string;
46
+ names?: Record<string, string[]>;
47
+ };
48
+ defaults?: {
49
+ apiUrl?: string;
50
+ port?: number;
51
+ };
52
+ allowNoKey?: boolean;
53
+ /** Printed for --help / -h (stdout) and after a configuration error (stderr). */
54
+ usage?: string;
55
+ /** Exit hook (tests replace process.exit). */
56
+ exit?: (code: number) => void;
57
+ /** Where messages go (default: process.stderr / process.stdout; stdout stays clean on stdio for JSON-RPC). */
58
+ out?: {
59
+ log: (s: string) => void;
60
+ error: (s: string) => void;
61
+ };
62
+ }
63
+ /**
64
+ * `bin` entry of a product MCP: reads NM_MCP_* (+ legacy names), lets the product build its options, starts stdio or
65
+ * HTTP (--http), closes cleanly on SIGTERM/SIGINT (core onShutdown). A configuration error prints the message and the
66
+ * usage on stderr and exits 2; --help prints the usage and exits 0. Returns the service (null after --help / error).
67
+ */
68
+ export declare function runCli(build: (cfg: EnvConfig, argv: string[]) => McpServiceOptions | Promise<McpServiceOptions>, o?: CliOptions): Promise<McpService | null>;
@@ -0,0 +1,98 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.startMcpService = startMcpService;
4
+ exports.mcpConfigFromEnv = mcpConfigFromEnv;
5
+ exports.runCli = runCli;
6
+ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
7
+ const core_1 = require("@nativemind108/core");
8
+ const client_js_1 = require("./client.js");
9
+ const http_js_1 = require("./http.js");
10
+ const hub_js_1 = require("./hub.js");
11
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/index.ts)
12
+ /** Starts the MCP service: Streamable HTTP when `transports.http` is set, else stdio. */
13
+ async function startMcpService(options) {
14
+ const log = options.logger ?? (0, core_1.getLogger)();
15
+ if (options.transports.http) {
16
+ const h = await (0, http_js_1.startHttp)(options);
17
+ log.info(`${options.product.name}: streamable HTTP at http://${options.transports.http.host}:${options.transports.http.port}${(options.routes?.[0] ?? http_js_1.DEFAULT_ROUTE).path}; API ${options.api.url}`);
18
+ return { app: h.app, close: h.close, toolsChanged: (match) => h.pool.notifyToolsChanged(match) };
19
+ }
20
+ if (!options.transports.stdio)
21
+ throw new core_1.ConfigError('startMcpService: set transports.http or transports.stdio.');
22
+ const hub = new hub_js_1.KeyHub(options, options.transports.stdio.apiKey);
23
+ try {
24
+ await hub.ensureFresh();
25
+ }
26
+ catch (error) {
27
+ if (error instanceof client_js_1.ApiCallError && (error.status === 401 || error.status === 403)) {
28
+ throw new core_1.ConfigError(`The ${options.product.title} API rejected the MCP API key (${error.code}: ${error.message}).`);
29
+ }
30
+ throw new core_1.ConfigError(`Cannot reach the ${options.product.title} API at ${options.api.url}: ${error instanceof Error ? error.message : String(error)}`);
31
+ }
32
+ hub.startTimer();
33
+ const route = options.routes?.[0] ?? http_js_1.DEFAULT_ROUTE;
34
+ const server = hub.createServer(route, {}, null, false, null);
35
+ await server.connect(new stdio_js_1.StdioServerTransport());
36
+ log.info(`${options.product.name}: ${hub.catalog?.operations.length ?? 0} catalog tools from ${options.api.url} on stdio`);
37
+ return { close: async () => { hub.stop(); await server.close(); }, toolsChanged: (match) => hub.notifyToolsChanged(match) };
38
+ }
39
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
40
+ /**
41
+ * NM_MCP_* configuration; `legacyPrefix` keeps old names working as aliases (spec S3: 'DX_MCP' → DX_MCP_API_URL …;
42
+ * PBN passes a map because its names differ).
43
+ */
44
+ function mcpConfigFromEnv(env = process.env, argv = [], legacy = {}, defaults = {},
45
+ /** 1.1: allowNoKey — stdio without a key is valid (a local MCP with only local tools, e.g. @consilium108/mcp offline). */
46
+ opts = {}) {
47
+ const e = (0, core_1.readEnv)(env);
48
+ const al = (name) => [...(legacy.prefix ? [`${legacy.prefix}_${name}`] : []), ...(legacy.names?.[name] ?? [])];
49
+ const httpMode = argv.includes('--http') || e.str('NM_MCP_TRANSPORT', '', al('TRANSPORT')).toLowerCase() === 'http';
50
+ const apiKey = e.str('NM_MCP_API_KEY', '', al('API_KEY')) || null;
51
+ if (!httpMode && !apiKey && !opts.allowNoKey)
52
+ throw new core_1.ConfigError('NM_MCP_API_KEY is required on stdio (an API key of your account).');
53
+ const toolsets = e.list('NM_MCP_TOOLSETS', [], al('TOOLSETS'));
54
+ const publicUrl = e.str('NM_MCP_PUBLIC_URL', '', al('PUBLIC_URL')).replace(/\/+$/, '') || undefined;
55
+ return {
56
+ apiUrl: e.url('NM_MCP_API_URL', defaults.apiUrl ?? 'http://localhost:3000', al('API_URL')),
57
+ publicUrl,
58
+ apiKey,
59
+ http: httpMode ? { host: e.str('NM_MCP_HTTP_HOST', '127.0.0.1', al('HTTP_HOST')), port: e.int('NM_MCP_HTTP_PORT', defaults.port ?? 8090, { min: 0, aliases: al('HTTP_PORT') }) } : null,
60
+ toolsets: toolsets.length ? toolsets : null,
61
+ maxRows: e.int('NM_MCP_MAX_ROWS', 25, { min: 1, aliases: al('MAX_ROWS') }),
62
+ maxBytes: e.int('NM_MCP_MAX_BYTES', 8192, { min: 1024, aliases: al('MAX_BYTES') }),
63
+ refreshMs: e.int('NM_MCP_REFRESH_MS', 60_000, { min: 1000, aliases: al('REFRESH_MS') }),
64
+ authServers: e.list('NM_MCP_AUTH_SERVER', [], al('AUTH_SERVER')),
65
+ };
66
+ }
67
+ // generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
68
+ /**
69
+ * `bin` entry of a product MCP: reads NM_MCP_* (+ legacy names), lets the product build its options, starts stdio or
70
+ * HTTP (--http), closes cleanly on SIGTERM/SIGINT (core onShutdown). A configuration error prints the message and the
71
+ * usage on stderr and exits 2; --help prints the usage and exits 0. Returns the service (null after --help / error).
72
+ */
73
+ async function runCli(build, o = {}) {
74
+ const argv = o.argv ?? process.argv.slice(2);
75
+ const exit = o.exit ?? ((code) => process.exit(code));
76
+ const out = o.out ?? { log: (t) => process.stderr.write(`${t}\n`), error: (t) => process.stderr.write(`${t}\n`) };
77
+ if (argv.includes('--help') || argv.includes('-h')) {
78
+ (o.out?.log ?? ((t) => process.stdout.write(`${t}\n`)))(o.usage ?? 'Usage: <mcp> [--http] (configuration: NM_MCP_* environment variables)');
79
+ exit(0);
80
+ return null;
81
+ }
82
+ try {
83
+ const cfg = mcpConfigFromEnv(o.env ?? process.env, argv, o.legacy ?? {}, o.defaults ?? {}, { allowNoKey: !!o.allowNoKey });
84
+ const service = await startMcpService(await build(cfg, argv));
85
+ (0, core_1.onShutdown)(() => service.close());
86
+ return service;
87
+ }
88
+ catch (error) {
89
+ if (!(error instanceof core_1.ConfigError))
90
+ throw error;
91
+ out.error(error.message);
92
+ if (o.usage)
93
+ out.error(o.usage);
94
+ exit(2);
95
+ return null;
96
+ }
97
+ }
98
+ //# sourceMappingURL=service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
2
+ import { type ApiClient, type ApiEnvelope, type CatalogOperation } from './client.js';
3
+ import { type OutputLimits, type ResultStore } from './output.js';
4
+ type Json = Record<string, unknown>;
5
+ export interface CatalogToolOptions {
6
+ /** Toolsets whose operations reach the outside world (openWorldHint). */
7
+ openWorld?: string[];
8
+ /** Jobs API of the product (`{basePath}/jobs/{id}`, `/result`); false: no job waiting tools. */
9
+ jobs?: {
10
+ path: string;
11
+ } | false;
12
+ /** List operations: describe filter/sort/fields/limit/cursor (dx / PBN list convention). */
13
+ listParams?: boolean;
14
+ }
15
+ export declare function catalogTool(op: CatalogOperation, o?: CatalogToolOptions): Tool;
16
+ export declare const JOB_TOOLS: Tool[];
17
+ export declare function hasJobs(ops: CatalogOperation[]): boolean;
18
+ export interface CatalogCallContext {
19
+ api: ApiClient;
20
+ store: ResultStore;
21
+ limits: OutputLimits;
22
+ options: CatalogToolOptions;
23
+ /** Product rewrite of arguments / result extras per tool (dx: refresh_wait aliases, `refresh` notes). */
24
+ rewriteArgs?: (op: CatalogOperation, args: Json) => Json;
25
+ resultExtra?: (op: CatalogOperation, body: ApiEnvelope) => Record<string, unknown>;
26
+ /** Called on a 403 (key policy / plan may have changed → re-read the catalog). */
27
+ onScopeDenied?: () => void;
28
+ }
29
+ /** Executes a catalog tool (or a job tool) as a REST call. */
30
+ export declare function callCatalogTool(ctx: CatalogCallContext, ops: CatalogOperation[], name: string, rawArgs: Json | undefined): Promise<CallToolResult | null>;
31
+ export {};
@@ -0,0 +1,124 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.JOB_TOOLS = void 0;
4
+ exports.catalogTool = catalogTool;
5
+ exports.hasJobs = hasJobs;
6
+ exports.callCatalogTool = callCatalogTool;
7
+ const client_js_1 = require("./client.js");
8
+ const output_js_1 = require("./output.js");
9
+ const TERMINAL = ['done', 'failed', 'cancelled'];
10
+ const MAX_WAIT_S = 30;
11
+ function inputSchema(op, o) {
12
+ const input = op.input;
13
+ const properties = { ...(input.properties ?? {}) };
14
+ const list = (op.list ?? null);
15
+ if (list && o.listParams !== false) {
16
+ const fields = Object.keys(list.fields).join(', ');
17
+ properties.filter ??= { type: 'object', description: `Filter as {field: {op: value}}; ops eq, ne, gt, gte, lt, lte, in, contains. Fields: ${fields}.` };
18
+ properties.sort ??= { type: 'string', description: `Comma-separated fields, "-" for descending${list.defaultSort?.length ? ` (default ${list.defaultSort.join(',')})` : ''}.` };
19
+ properties.fields ??= { type: 'string', description: 'Comma-separated fields to return (sparse rows keep outputs small).' };
20
+ properties.limit ??= { type: 'integer', minimum: 1, maximum: 100, description: 'Page size.' };
21
+ properties.cursor ??= { type: 'string', description: 'nextCursor from the previous page.' };
22
+ }
23
+ if (op.safety === 'job' && o.jobs) {
24
+ properties.wait ??= { type: 'integer', minimum: 0, maximum: MAX_WAIT_S, default: 0, description: `Seconds to wait for completion (0–${MAX_WAIT_S}); when done the tool returns the job result, otherwise the job to poll with jobs_wait.` };
25
+ }
26
+ return { type: 'object', properties, ...(input.required?.length ? { required: input.required } : {}) };
27
+ }
28
+ function describe(op, o) {
29
+ const notes = [];
30
+ if (op.safety === 'destructive' || op.safety === 'money')
31
+ notes.push(`${op.safety === 'money' ? 'Spends money / changes paid resources' : 'Destructive'}: without "confirm": true it only returns a dry-run preview; ask the user before confirming.`);
32
+ if (op.safety === 'job' && o.jobs)
33
+ notes.push('Runs as a background job (pass "wait" to block up to 30 s).');
34
+ if (op.list && o.listParams !== false)
35
+ notes.push('Paginated list: use filter/sort/fields/limit/cursor.');
36
+ return [op.mcp?.description ?? op.description, ...notes, `[${op.id} · toolset ${op.toolset}]`].join('\n\n');
37
+ }
38
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
39
+ function catalogTool(op, o = {}) {
40
+ const read = op.safety === 'read';
41
+ return {
42
+ name: op.mcp.name,
43
+ title: op.mcp.title,
44
+ description: describe(op, o),
45
+ inputSchema: inputSchema(op, o),
46
+ annotations: {
47
+ title: op.mcp.title,
48
+ readOnlyHint: read || (op.safety === 'job' && op.readOnlyJob),
49
+ destructiveHint: op.safety === 'destructive' || op.safety === 'money',
50
+ idempotentHint: read || op.rest?.method === 'PUT',
51
+ openWorldHint: (o.openWorld ?? []).includes(op.toolset),
52
+ },
53
+ };
54
+ }
55
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
56
+ exports.JOB_TOOLS = [
57
+ {
58
+ name: 'jobs_wait',
59
+ title: 'Wait for a job',
60
+ description: 'Waits up to `timeoutSec` (≤ 30) for a job started by another tool; returns the result when done, otherwise the current status/progress (call again to keep waiting).',
61
+ inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Job id' }, timeoutSec: { type: 'integer', minimum: 0, maximum: MAX_WAIT_S, default: 25 } }, required: ['id'] },
62
+ annotations: { title: 'Wait for a job', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
63
+ },
64
+ {
65
+ name: 'jobs_result',
66
+ title: 'Job result',
67
+ description: 'Returns the result of a finished job (409 JOB_NOT_DONE while it is still running).',
68
+ inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Job id' } }, required: ['id'] },
69
+ annotations: { title: 'Job result', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
70
+ },
71
+ ];
72
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
73
+ function hasJobs(ops) {
74
+ return ops.some((op) => op.safety === 'job' || op.toolset === 'jobs');
75
+ }
76
+ async function waitForJob(api, jobsPath, id, seconds) {
77
+ const deadline = Date.now() + seconds * 1000;
78
+ let job = await api.request('GET', `${jobsPath}/{id}`, { id });
79
+ while (!TERMINAL.includes(job.body.data.status) && Date.now() < deadline) {
80
+ const left = Math.max(1, Math.ceil((deadline - Date.now()) / 1000));
81
+ job = await api.request('GET', `${jobsPath}/{id}`, { id, wait: Math.min(left, MAX_WAIT_S) });
82
+ }
83
+ if (job.body.data.status !== 'done')
84
+ return job.body;
85
+ return (await api.request('GET', `${jobsPath}/{id}/result`, { id })).body;
86
+ }
87
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
88
+ /** Executes a catalog tool (or a job tool) as a REST call. */
89
+ async function callCatalogTool(ctx, ops, name, rawArgs) {
90
+ let args = { ...(rawArgs ?? {}) };
91
+ const jobs = ctx.options.jobs;
92
+ try {
93
+ const op = ops.find((o) => o.mcp?.name === name);
94
+ if (!op && jobs && (name === 'jobs_wait' || name === 'jobs_result') && hasJobs(ops)) {
95
+ const id = String(args.id ?? '');
96
+ if (!id)
97
+ return (0, output_js_1.errorResult)(new client_js_1.ApiCallError(400, 'VALIDATION_ERROR', 'id is required.', [{ field: 'id', reason: 'is required' }]));
98
+ const body = name === 'jobs_wait'
99
+ ? await waitForJob(ctx.api, jobs.path, id, Math.min(Number(args.timeoutSec ?? 25), MAX_WAIT_S))
100
+ : (await ctx.api.request('GET', `${jobs.path}/{id}/result`, { id })).body;
101
+ return (0, output_js_1.toolResult)(body, ctx.limits, ctx.store);
102
+ }
103
+ if (!op || !op.rest)
104
+ return null;
105
+ if (ctx.rewriteArgs)
106
+ args = ctx.rewriteArgs(op, args);
107
+ const wait = op.safety === 'job' && jobs ? Math.min(Number(args.wait ?? 0), MAX_WAIT_S) : 0;
108
+ if (op.safety === 'job')
109
+ delete args.wait;
110
+ const res = await ctx.api.request(op.rest.method, op.rest.path, args);
111
+ if (jobs && op.safety === 'job' && wait > 0 && res.status === 202) {
112
+ const jobId = res.body.data.id;
113
+ if (jobId)
114
+ return (0, output_js_1.toolResult)(await waitForJob(ctx.api, jobs.path, jobId, wait), ctx.limits, ctx.store);
115
+ }
116
+ return (0, output_js_1.toolResult)(res.body, ctx.limits, ctx.store, ctx.resultExtra?.(op, res.body) ?? {});
117
+ }
118
+ catch (error) {
119
+ if (error instanceof client_js_1.ApiCallError && error.status === 403)
120
+ ctx.onScopeDenied?.();
121
+ return (0, output_js_1.errorResult)(error);
122
+ }
123
+ }
124
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { RouteContext } from './options.js';
3
+ /**
4
+ * What a tool needs. The package does not interpret it: `scope` / `kind` are the product's words (Konsilium:
5
+ * kind 'project' | 'me' | 'global', scope 'tasks:work' …). `also` = a second requirement that must hold too.
6
+ */
7
+ export interface ToolRequirement {
8
+ scope: string;
9
+ kind?: string;
10
+ also?: ToolRequirement;
11
+ }
12
+ /**
13
+ * The product's access policy (Konsilium: @consilium108/mcp). Evaluated live on every tools/list and tools/call, so a
14
+ * changed right applies at once; hiding is not protection — the API still checks every call.
15
+ */
16
+ export interface AccessPolicy {
17
+ /** May this session use the tool now? `requires` undefined = a tool without a right (always allowed by default). */
18
+ allowed(requires: ToolRequirement | undefined, tool: string, ctx: RouteContext): boolean;
19
+ /** Refusal text for a hidden tool called anyway (where the person changes access). Default: a generic text. */
20
+ refusal?(tool: string, requires: ToolRequirement | undefined, ctx: RouteContext): string;
21
+ }
22
+ /** A tool hidden from this session and what it needs — for an «access» tool, so the model can tell the person what to ask for. */
23
+ export interface HiddenTool {
24
+ name: string;
25
+ needs: string[];
26
+ kind: string | null;
27
+ }
28
+ /** Session descriptor passed to `toolsChanged(match)` — choose which open sessions re-list their tools. */
29
+ export interface SessionInfo {
30
+ route: string;
31
+ params: Record<string, string>;
32
+ session: Record<string, unknown>;
33
+ keyHash: string | null;
34
+ }
35
+ /** Flattened scope list of a requirement (`also` chain). */
36
+ export declare function needsOf(requires: ToolRequirement | undefined): string[];
37
+ /**
38
+ * The refusal returned for a tool the policy hides (the client may still have it in a cached tools/list). It tells
39
+ * caching clients to re-list; `ACCESS_DENIED` is the error code in structuredContent.
40
+ */
41
+ export declare function accessDeniedResult(tool: string, requires: ToolRequirement | undefined, text?: string): CallToolResult;
42
+ //# sourceMappingURL=access.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAGD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oHAAoH;IACpH,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC;IACzF,+GAA+G;IAC/G,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,SAAS,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC;CAC1F;AAGD,kIAAkI;AAClI,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAGD,2GAA2G;AAC3G,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAGD,4DAA4D;AAC5D,wBAAgB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,EAAE,CAIvE;AAGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CASrH"}
@@ -0,0 +1,24 @@
1
+ // generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
2
+ /** Flattened scope list of a requirement (`also` chain). */
3
+ export function needsOf(requires) {
4
+ const out = [];
5
+ for (let r = requires; r; r = r.also)
6
+ out.push(r.scope);
7
+ return out;
8
+ }
9
+ // generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
10
+ /**
11
+ * The refusal returned for a tool the policy hides (the client may still have it in a cached tools/list). It tells
12
+ * caching clients to re-list; `ACCESS_DENIED` is the error code in structuredContent.
13
+ */
14
+ export function accessDeniedResult(tool, requires, text) {
15
+ const needs = needsOf(requires);
16
+ const message = text ?? `Tool ${tool} is not available to this connection now${needs.length ? ` (needs: ${needs.join(', ')})` : ''}. Only the person can change access.`;
17
+ const hint = 'If your tool list is cached, request tools/list again.';
18
+ return {
19
+ isError: true,
20
+ content: [{ type: 'text', text: `${message} ${hint}` }],
21
+ structuredContent: { error: { code: 'ACCESS_DENIED', message, needs, hint } },
22
+ };
23
+ }
24
+ //# sourceMappingURL=access.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/access.ts"],"names":[],"mappings":"AA2CA,0EAA0E;AAC1E,4DAA4D;AAC5D,MAAM,UAAU,OAAO,CAAC,QAAqC;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAAqC,EAAE,IAAa;IACnG,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,IAAI,2CAA2C,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sCAAsC,CAAC;IACzK,MAAM,IAAI,GAAG,wDAAwD,CAAC;IACtE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,IAAI,IAAI,EAAE,EAAE,CAAC;QACvD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;KAC9E,CAAC;AACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ import type { ApiClient, CatalogOperation } from './client.js';
2
+ /**
3
+ * The operations one key may use over MCP: the API catalog (already filtered by the key policy) narrowed by the
4
+ * configured toolsets, without 501 stubs. `refresh()` reports whether the set changed (→ tools/list_changed).
5
+ */
6
+ export declare class Catalog {
7
+ private readonly client;
8
+ private readonly toolsets;
9
+ private ops;
10
+ private fingerprint;
11
+ private loaded;
12
+ private inflight;
13
+ /** Epoch ms of the last successful fetch (0 = never). */
14
+ loadedAt: number;
15
+ constructor(client: ApiClient, toolsets: Set<string> | null);
16
+ get operations(): CatalogOperation[];
17
+ get isLoaded(): boolean;
18
+ byToolName(name: string): CatalogOperation | undefined;
19
+ /** Re-reads the catalog; resolves true when the exposed operation set changed. Concurrent calls share one fetch. */
20
+ refresh(): Promise<boolean>;
21
+ }
22
+ //# sourceMappingURL=catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D;;;GAGG;AACH,qBAAa,OAAO;IAQN,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAa,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAPzE,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAiC;IACjD,yDAAyD;IACzD,QAAQ,SAAK;gBAEgB,MAAM,EAAE,SAAS,EAAmB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAE7F,IAAI,UAAU,IAAI,gBAAgB,EAAE,CAEnC;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAItD,oHAAoH;IACpH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAmB5B"}
@@ -0,0 +1,50 @@
1
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/catalog.ts)
2
+ /**
3
+ * The operations one key may use over MCP: the API catalog (already filtered by the key policy) narrowed by the
4
+ * configured toolsets, without 501 stubs. `refresh()` reports whether the set changed (→ tools/list_changed).
5
+ */
6
+ export class Catalog {
7
+ client;
8
+ toolsets;
9
+ ops = [];
10
+ fingerprint = '';
11
+ loaded = false;
12
+ inflight = null;
13
+ /** Epoch ms of the last successful fetch (0 = never). */
14
+ loadedAt = 0;
15
+ constructor(client, toolsets) {
16
+ this.client = client;
17
+ this.toolsets = toolsets;
18
+ }
19
+ get operations() {
20
+ return this.ops;
21
+ }
22
+ get isLoaded() {
23
+ return this.loaded;
24
+ }
25
+ byToolName(name) {
26
+ return this.ops.find((op) => op.mcp?.name === name);
27
+ }
28
+ /** Re-reads the catalog; resolves true when the exposed operation set changed. Concurrent calls share one fetch. */
29
+ refresh() {
30
+ this.inflight ??= (async () => {
31
+ try {
32
+ const all = await this.client.catalog();
33
+ const next = all.filter((op) => op.mcp && op.rest && op.implemented !== false && (!this.toolsets || this.toolsets.has(op.toolset)));
34
+ next.sort((a, b) => a.id.localeCompare(b.id));
35
+ const fingerprint = next.map((op) => `${op.id}:${op.safety}`).join('|');
36
+ const changed = this.loaded && fingerprint !== this.fingerprint;
37
+ this.ops = next;
38
+ this.fingerprint = fingerprint;
39
+ this.loaded = true;
40
+ this.loadedAt = Date.now();
41
+ return changed;
42
+ }
43
+ finally {
44
+ this.inflight = null;
45
+ }
46
+ })();
47
+ return this.inflight;
48
+ }
49
+ }
50
+ //# sourceMappingURL=catalog.js.map