@nativemind108/mcp 0.0.0-stage → 1.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 (83) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/LICENSE +289 -0
  3. package/NOTICE +5 -0
  4. package/README.md +29 -2
  5. package/dist/cjs/catalog.d.ts +21 -0
  6. package/dist/cjs/catalog.js +54 -0
  7. package/dist/cjs/catalog.js.map +1 -0
  8. package/dist/cjs/client.d.ts +59 -0
  9. package/dist/cjs/client.js +107 -0
  10. package/dist/cjs/client.js.map +1 -0
  11. package/dist/cjs/define.d.ts +37 -0
  12. package/dist/cjs/define.js +26 -0
  13. package/dist/cjs/define.js.map +1 -0
  14. package/dist/cjs/feedback.d.ts +21 -0
  15. package/dist/cjs/feedback.js +77 -0
  16. package/dist/cjs/feedback.js.map +1 -0
  17. package/dist/cjs/http.d.ts +15 -0
  18. package/dist/cjs/http.js +192 -0
  19. package/dist/cjs/http.js.map +1 -0
  20. package/dist/cjs/hub.d.ts +42 -0
  21. package/dist/cjs/hub.js +284 -0
  22. package/dist/cjs/hub.js.map +1 -0
  23. package/dist/cjs/index.d.ts +10 -0
  24. package/dist/cjs/index.js +28 -0
  25. package/dist/cjs/index.js.map +1 -0
  26. package/dist/cjs/options.d.ts +119 -0
  27. package/dist/cjs/options.js +3 -0
  28. package/dist/cjs/options.js.map +1 -0
  29. package/dist/cjs/output.d.ts +23 -0
  30. package/dist/cjs/output.js +88 -0
  31. package/dist/cjs/output.js.map +1 -0
  32. package/dist/cjs/package.json +3 -0
  33. package/dist/cjs/service.d.ts +33 -0
  34. package/dist/cjs/service.js +64 -0
  35. package/dist/cjs/service.js.map +1 -0
  36. package/dist/cjs/tools.d.ts +31 -0
  37. package/dist/cjs/tools.js +124 -0
  38. package/dist/cjs/tools.js.map +1 -0
  39. package/dist/esm/catalog.d.ts +22 -0
  40. package/dist/esm/catalog.d.ts.map +1 -0
  41. package/dist/esm/catalog.js +50 -0
  42. package/dist/esm/catalog.js.map +1 -0
  43. package/dist/esm/client.d.ts +60 -0
  44. package/dist/esm/client.d.ts.map +1 -0
  45. package/dist/esm/client.js +102 -0
  46. package/dist/esm/client.js.map +1 -0
  47. package/dist/esm/define.d.ts +38 -0
  48. package/dist/esm/define.d.ts.map +1 -0
  49. package/dist/esm/define.js +22 -0
  50. package/dist/esm/define.js.map +1 -0
  51. package/dist/esm/feedback.d.ts +22 -0
  52. package/dist/esm/feedback.d.ts.map +1 -0
  53. package/dist/esm/feedback.js +73 -0
  54. package/dist/esm/feedback.js.map +1 -0
  55. package/dist/esm/http.d.ts +16 -0
  56. package/dist/esm/http.d.ts.map +1 -0
  57. package/dist/esm/http.js +185 -0
  58. package/dist/esm/http.js.map +1 -0
  59. package/dist/esm/hub.d.ts +43 -0
  60. package/dist/esm/hub.d.ts.map +1 -0
  61. package/dist/esm/hub.js +275 -0
  62. package/dist/esm/hub.js.map +1 -0
  63. package/dist/esm/index.d.ts +11 -0
  64. package/dist/esm/index.d.ts.map +1 -0
  65. package/dist/esm/index.js +12 -0
  66. package/dist/esm/index.js.map +1 -0
  67. package/dist/esm/options.d.ts +120 -0
  68. package/dist/esm/options.d.ts.map +1 -0
  69. package/dist/esm/options.js +2 -0
  70. package/dist/esm/options.js.map +1 -0
  71. package/dist/esm/output.d.ts +24 -0
  72. package/dist/esm/output.d.ts.map +1 -0
  73. package/dist/esm/output.js +79 -0
  74. package/dist/esm/output.js.map +1 -0
  75. package/dist/esm/service.d.ts +34 -0
  76. package/dist/esm/service.d.ts.map +1 -0
  77. package/dist/esm/service.js +60 -0
  78. package/dist/esm/service.js.map +1 -0
  79. package/dist/esm/tools.d.ts +32 -0
  80. package/dist/esm/tools.d.ts.map +1 -0
  81. package/dist/esm/tools.js +118 -0
  82. package/dist/esm/tools.js.map +1 -0
  83. package/package.json +59 -4
@@ -0,0 +1,64 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.startMcpService = startMcpService;
4
+ exports.mcpConfigFromEnv = mcpConfigFromEnv;
5
+ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
6
+ const core_1 = require("@nativemind108/core");
7
+ const client_js_1 = require("./client.js");
8
+ const http_js_1 = require("./http.js");
9
+ const hub_js_1 = require("./hub.js");
10
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/index.ts)
11
+ /** Starts the MCP service: Streamable HTTP when `transports.http` is set, else stdio. */
12
+ async function startMcpService(options) {
13
+ const log = options.logger ?? (0, core_1.getLogger)();
14
+ if (options.transports.http) {
15
+ const h = await (0, http_js_1.startHttp)(options);
16
+ 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}`);
17
+ return { app: h.app, close: h.close };
18
+ }
19
+ if (!options.transports.stdio)
20
+ throw new core_1.ConfigError('startMcpService: set transports.http or transports.stdio.');
21
+ const hub = new hub_js_1.KeyHub(options, options.transports.stdio.apiKey);
22
+ try {
23
+ await hub.ensureFresh();
24
+ }
25
+ catch (error) {
26
+ if (error instanceof client_js_1.ApiCallError && (error.status === 401 || error.status === 403)) {
27
+ throw new core_1.ConfigError(`The ${options.product.title} API rejected the MCP API key (${error.code}: ${error.message}).`);
28
+ }
29
+ throw new core_1.ConfigError(`Cannot reach the ${options.product.title} API at ${options.api.url}: ${error instanceof Error ? error.message : String(error)}`);
30
+ }
31
+ hub.startTimer();
32
+ const route = options.routes?.[0] ?? http_js_1.DEFAULT_ROUTE;
33
+ const server = hub.createServer(route, {}, null, false, null);
34
+ await server.connect(new stdio_js_1.StdioServerTransport());
35
+ log.info(`${options.product.name}: ${hub.catalog?.operations.length ?? 0} catalog tools from ${options.api.url} on stdio`);
36
+ return { close: async () => { hub.stop(); await server.close(); } };
37
+ }
38
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
39
+ /**
40
+ * NM_MCP_* configuration; `legacyPrefix` keeps old names working as aliases (spec S3: 'DX_MCP' → DX_MCP_API_URL …;
41
+ * PBN passes a map because its names differ).
42
+ */
43
+ function mcpConfigFromEnv(env = process.env, argv = [], legacy = {}, defaults = {}) {
44
+ const e = (0, core_1.readEnv)(env);
45
+ const al = (name) => [...(legacy.prefix ? [`${legacy.prefix}_${name}`] : []), ...(legacy.names?.[name] ?? [])];
46
+ const httpMode = argv.includes('--http') || e.str('NM_MCP_TRANSPORT', '', al('TRANSPORT')).toLowerCase() === 'http';
47
+ const apiKey = e.str('NM_MCP_API_KEY', '', al('API_KEY')) || null;
48
+ if (!httpMode && !apiKey)
49
+ throw new core_1.ConfigError('NM_MCP_API_KEY is required on stdio (an API key of your account).');
50
+ const toolsets = e.list('NM_MCP_TOOLSETS', [], al('TOOLSETS'));
51
+ const publicUrl = e.str('NM_MCP_PUBLIC_URL', '', al('PUBLIC_URL')).replace(/\/+$/, '') || undefined;
52
+ return {
53
+ apiUrl: e.url('NM_MCP_API_URL', defaults.apiUrl ?? 'http://localhost:3000', al('API_URL')),
54
+ publicUrl,
55
+ apiKey,
56
+ 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,
57
+ toolsets: toolsets.length ? toolsets : null,
58
+ maxRows: e.int('NM_MCP_MAX_ROWS', 25, { min: 1, aliases: al('MAX_ROWS') }),
59
+ maxBytes: e.int('NM_MCP_MAX_BYTES', 8192, { min: 1024, aliases: al('MAX_BYTES') }),
60
+ refreshMs: e.int('NM_MCP_REFRESH_MS', 60_000, { min: 1000, aliases: al('REFRESH_MS') }),
61
+ authServers: e.list('NM_MCP_AUTH_SERVER', [], al('AUTH_SERVER')),
62
+ };
63
+ }
64
+ //# 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,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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/catalog.ts"],"names":[],"mappings":"AAEA,iIAAiI;AACjI;;;GAGG;AACH,MAAM,OAAO,OAAO;IAQW;IAAoC;IAPzD,GAAG,GAAuB,EAAE,CAAC;IAC7B,WAAW,GAAG,EAAE,CAAC;IACjB,MAAM,GAAG,KAAK,CAAC;IACf,QAAQ,GAA4B,IAAI,CAAC;IACjD,yDAAyD;IACzD,QAAQ,GAAG,CAAC,CAAC;IAEb,YAA6B,MAAiB,EAAmB,QAA4B;QAAhE,WAAM,GAAN,MAAM,CAAW;QAAmB,aAAQ,GAAR,QAAQ,CAAoB;IAAG,CAAC;IAEjG,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,oHAAoH;IACpH,OAAO;QACL,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACpI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,KAAK,IAAI,CAAC,WAAW,CAAC;gBAChE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC;YACjB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}
@@ -0,0 +1,60 @@
1
+ import type { CatalogOperation } from '@nativemind108/api';
2
+ export type { CatalogOperation } from "@nativemind108/api";
3
+ export interface ApiEnvelope<T = unknown> {
4
+ data: T;
5
+ meta?: {
6
+ requestId?: string;
7
+ page?: {
8
+ nextCursor: string | null;
9
+ hasMore?: boolean;
10
+ total?: number;
11
+ totalEstimate?: number;
12
+ };
13
+ refresh?: {
14
+ id: string;
15
+ status: string;
16
+ kinds?: string[];
17
+ eta?: string | null;
18
+ reason?: string;
19
+ };
20
+ [extra: string]: unknown;
21
+ };
22
+ }
23
+ export declare class ApiCallError extends Error {
24
+ readonly status: number;
25
+ readonly code: string;
26
+ readonly details: unknown;
27
+ readonly preview?: unknown | undefined;
28
+ readonly requestId?: string | undefined;
29
+ constructor(status: number, code: string, message: string, details?: unknown, preview?: unknown | undefined, requestId?: string | undefined);
30
+ }
31
+ export interface ApiClientOptions {
32
+ /** Prefix of catalog and generic paths ('/v1', '/api/v1', '/api'). */
33
+ basePath: string;
34
+ /** Headers marking the MCP service as the caller (default `X-NM-Client: mcp`; dx adds `X-DX-Client: mcp`). */
35
+ clientHeaders?: Record<string, string>;
36
+ userAgent?: string;
37
+ fetch?: typeof fetch;
38
+ /** Request timeout, ms (default 60 s). */
39
+ timeoutMs?: number;
40
+ }
41
+ /** Thin REST client of the product API (`{data, meta}` / `{error}`); every request carries the caller's bearer. */
42
+ export declare class ApiClient {
43
+ readonly baseUrl: string;
44
+ private apiKey;
45
+ readonly options: ApiClientOptions;
46
+ private extra;
47
+ constructor(baseUrl: string, apiKey: string | null, options: ApiClientOptions);
48
+ /** OAuth access tokens rotate: a session of the same grant continues with the new token. */
49
+ setKey(apiKey: string | null): void;
50
+ /** Headers added to every request of this client (e.g. X-NM-MCP-Client of the session). */
51
+ setHeaders(headers: Record<string, string>): void;
52
+ get basePath(): string;
53
+ request<T = unknown>(method: string, path: string, args?: Record<string, unknown>, headers?: Record<string, string>): Promise<{
54
+ status: number;
55
+ body: ApiEnvelope<T>;
56
+ headers: Headers;
57
+ }>;
58
+ catalog(): Promise<CatalogOperation[]>;
59
+ }
60
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAChG,OAAO,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACjG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;KAC1B,CAAC;CACH;AAGD,qBAAa,YAAa,SAAQ,KAAK;IAEnC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,OAAO,EAAE,OAAO;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;gBALlB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,OAAO,GAAE,OAAY,EACrB,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,SAAS,CAAC,EAAE,MAAM,YAAA;CAK9B;AAGD,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,8GAA8G;IAC9G,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,mHAAmH;AACnH,qBAAa,SAAS;IAGR,QAAQ,CAAC,OAAO,EAAE,MAAM;IAAE,OAAO,CAAC,MAAM;IAAiB,QAAQ,CAAC,OAAO,EAAE,gBAAgB;IAFvG,OAAO,CAAC,KAAK,CAA8B;gBAEtB,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,GAAG,IAAI,EAAW,OAAO,EAAE,gBAAgB;IAEvG,4FAA4F;IAC5F,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAInC,2FAA2F;IAC3F,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEK,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAyCjM,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAI7C"}
@@ -0,0 +1,102 @@
1
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
2
+ export class ApiCallError extends Error {
3
+ status;
4
+ code;
5
+ details;
6
+ preview;
7
+ requestId;
8
+ constructor(status, code, message, details = [], preview, requestId) {
9
+ super(message);
10
+ this.status = status;
11
+ this.code = code;
12
+ this.details = details;
13
+ this.preview = preview;
14
+ this.requestId = requestId;
15
+ this.name = 'ApiCallError';
16
+ }
17
+ }
18
+ /** `filter: {tf: {gte: 5}}` → `filter[tf][gte]=5` (the REST list convention). */
19
+ function appendQuery(qs, key, value) {
20
+ if (value === undefined || value === null)
21
+ return;
22
+ if (Array.isArray(value))
23
+ qs.append(key, value.map(String).join(','));
24
+ else if (typeof value === 'object')
25
+ for (const [k, v] of Object.entries(value))
26
+ appendQuery(qs, `${key}[${k}]`, v);
27
+ else
28
+ qs.append(key, String(value));
29
+ }
30
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
31
+ /** Thin REST client of the product API (`{data, meta}` / `{error}`); every request carries the caller's bearer. */
32
+ export class ApiClient {
33
+ baseUrl;
34
+ apiKey;
35
+ options;
36
+ extra = {};
37
+ constructor(baseUrl, apiKey, options) {
38
+ this.baseUrl = baseUrl;
39
+ this.apiKey = apiKey;
40
+ this.options = options;
41
+ }
42
+ /** OAuth access tokens rotate: a session of the same grant continues with the new token. */
43
+ setKey(apiKey) {
44
+ this.apiKey = apiKey;
45
+ }
46
+ /** Headers added to every request of this client (e.g. X-NM-MCP-Client of the session). */
47
+ setHeaders(headers) {
48
+ this.extra = { ...this.extra, ...headers };
49
+ }
50
+ get basePath() {
51
+ return this.options.basePath;
52
+ }
53
+ async request(method, path, args = {}, headers = {}) {
54
+ const rest = { ...args };
55
+ const url = path.replace(/\{([A-Za-z0-9_]+)\}/g, (_m, name) => {
56
+ const value = rest[name];
57
+ if (value === undefined || value === null || value === '')
58
+ throw new ApiCallError(400, 'VALIDATION_ERROR', `Missing path parameter "${name}".`, [{ field: name, reason: 'is required' }]);
59
+ delete rest[name];
60
+ return encodeURIComponent(String(value));
61
+ });
62
+ const upper = method.toUpperCase();
63
+ const withBody = upper === 'POST' || upper === 'PUT' || upper === 'PATCH' || (upper === 'DELETE' && Object.keys(rest).length > 0);
64
+ const qs = new URLSearchParams();
65
+ if (!withBody)
66
+ for (const [k, v] of Object.entries(rest))
67
+ appendQuery(qs, k, v);
68
+ const query = qs.toString();
69
+ const res = await (this.options.fetch ?? fetch)(`${this.baseUrl}${url}${query ? `?${query}` : ''}`, {
70
+ method: upper,
71
+ signal: AbortSignal.timeout(this.options.timeoutMs ?? 60_000),
72
+ headers: {
73
+ ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
74
+ Accept: 'application/json',
75
+ 'User-Agent': this.options.userAgent ?? 'nativemind-mcp/1',
76
+ ...(this.options.clientHeaders ?? { 'X-NM-Client': 'mcp' }),
77
+ ...this.extra,
78
+ ...headers,
79
+ ...(withBody ? { 'Content-Type': 'application/json' } : {}),
80
+ },
81
+ ...(withBody ? { body: JSON.stringify(rest) } : {}),
82
+ });
83
+ const text = await res.text();
84
+ let body = null;
85
+ try {
86
+ body = text ? JSON.parse(text) : null;
87
+ }
88
+ catch {
89
+ body = { raw: text };
90
+ }
91
+ if (!res.ok) {
92
+ const err = body?.error;
93
+ throw new ApiCallError(res.status, err?.code ?? `HTTP_${res.status}`, err?.message ?? `API answered ${res.status}.`, err?.details ?? [], err?.preview, err?.requestId);
94
+ }
95
+ return { status: res.status, body: (body ?? { data: null }), headers: res.headers };
96
+ }
97
+ async catalog() {
98
+ const res = await this.request('GET', `${this.options.basePath}/meta/operations`, { mcpOnly: true });
99
+ return res.body.data.operations;
100
+ }
101
+ }
102
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import { z, type ZodRawShape } from 'zod';
2
+ import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
3
+ import type { ApiClient } from './client.js';
4
+ /** What a hand-written tool receives on a call. */
5
+ export interface ToolCallContext {
6
+ /** API client of the session (the caller's bearer, X-NM-Client: mcp). */
7
+ api: ApiClient;
8
+ /** Route params of the MCP endpoint (Konsilium: `{ projectId }` of /mcp/p/:projectId). */
9
+ params: Record<string, string>;
10
+ /** Language of the session (?lang= or the product's resolver). */
11
+ lang: string | null;
12
+ /** `name version` of the MCP client (initialize clientInfo). */
13
+ client: string;
14
+ /** Product data attached to the route / session. */
15
+ extra: Record<string, unknown>;
16
+ }
17
+ /** A hand-written tool (product tools, feedback tools). The handler returns plain data (wrapped as `{data}`) or a CallToolResult. */
18
+ export interface ToolDefinition {
19
+ name: string;
20
+ title: string;
21
+ description: string;
22
+ inputSchema: Tool['inputSchema'];
23
+ annotations?: Tool['annotations'];
24
+ /** Parses / validates raw arguments (zod tools); throws ZodError on bad input. */
25
+ parse?: (args: unknown) => unknown;
26
+ call: (args: any, ctx: ToolCallContext) => Promise<unknown>;
27
+ }
28
+ export declare function isCallToolResult(value: unknown): value is CallToolResult;
29
+ /** A tool with a zod input shape (as Konsilium's `server.registerTool`); JSON Schema for tools/list via z.toJSONSchema. */
30
+ export declare function defineTool<S extends ZodRawShape>(def: {
31
+ name: string;
32
+ title: string;
33
+ description: string;
34
+ input: S;
35
+ annotations?: Tool['annotations'];
36
+ call: (args: z.infer<z.ZodObject<S>>, ctx: ToolCallContext) => Promise<unknown>;
37
+ }): ToolDefinition;
38
+ //# sourceMappingURL=define.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,GAAG,EAAE,SAAS,CAAC;IACf,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kEAAkE;IAClE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAGD,qIAAqI;AACrI,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAClC,kFAAkF;IAClF,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAGD,2HAA2H;AAC3H,wBAAgB,UAAU,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjF,GAAG,cAAc,CAajB"}
@@ -0,0 +1,22 @@
1
+ import { z } from 'zod';
2
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
3
+ export function isCallToolResult(value) {
4
+ return !!value && typeof value === 'object' && Array.isArray(value.content);
5
+ }
6
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
7
+ /** A tool with a zod input shape (as Konsilium's `server.registerTool`); JSON Schema for tools/list via z.toJSONSchema. */
8
+ export function defineTool(def) {
9
+ const schema = z.object(def.input);
10
+ const json = z.toJSONSchema(schema, { target: 'draft-2020-12', io: 'input' });
11
+ delete json.$schema;
12
+ return {
13
+ name: def.name,
14
+ title: def.title,
15
+ description: def.description,
16
+ inputSchema: { ...json, type: 'object' },
17
+ ...(def.annotations ? { annotations: def.annotations } : {}),
18
+ parse: (args) => schema.parse(args ?? {}),
19
+ call: def.call,
20
+ };
21
+ }
22
+ //# sourceMappingURL=define.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAgC1C,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,KAA+B,CAAC,OAAO,CAAC,CAAC;AACzG,CAAC;AAED,kFAAkF;AAClF,2HAA2H;AAC3H,MAAM,UAAU,UAAU,CAAwB,GAOjD;IACC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,OAAO,EAAE,CAA4B,CAAC;IACzG,OAAO,IAAI,CAAC,OAAO,CAAC;IACpB,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAyB;QAC/D,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QACzC,IAAI,EAAE,GAAG,CAAC,IAA8B;KACzC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ import type { ToolDefinition } from './define.js';
2
+ export declare const FEEDBACK_TOOL_NAMES: readonly ["report_bug", "suggest_improvement", "leave_review", "add_feedback_note", "my_feedback"];
3
+ export type FeedbackToolName = (typeof FEEDBACK_TOOL_NAMES)[number];
4
+ export interface FeedbackToolsOptions {
5
+ /** Product title in descriptions ("Report a bug in dropexpired itself …"). */
6
+ product: string;
7
+ /** API base path of the contract ('/v1', '/api'). */
8
+ basePath: string;
9
+ /** Product wording / extras: title + description per tool. */
10
+ describe?: (tool: FeedbackToolName) => {
11
+ title?: string;
12
+ description?: string;
13
+ } | undefined;
14
+ /** Product extras added to a successful result (Konsilium: `next` thank-you text). */
15
+ decorate?: (tool: FeedbackToolName, data: Record<string, unknown>, lang: string | null) => Record<string, unknown>;
16
+ }
17
+ /**
18
+ * The five feedback tools. They are registered on every MCP server of every product and cannot be turned off.
19
+ * A product whose API has no storage yet answers 501 → the tool returns isError with a plain message (no exception).
20
+ */
21
+ export declare function feedbackTools(o: FeedbackToolsOptions): ToolDefinition[];
22
+ //# sourceMappingURL=feedback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/feedback.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,mBAAmB,oGAAqG,CAAC;AAEtI,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGpE,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5F,sFAAsF;IACtF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpH;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAoDvE"}